@cosmicdrift/kumiko-framework 0.413.1 → 0.415.0
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/AGENTS.md +5 -2
- package/agents/api/framework-db.md +14 -3
- package/agents/api/framework-engine.md +69 -13
- package/agents/api/framework-errors.md +1 -1
- package/agents/api/framework-event-store.md +14 -0
- package/agents/api/framework-ui-types.md +158 -21
- package/agents/api/renderer-web.md +112 -11
- package/agents/api/testing-helpers.md +3 -2
- package/agents/api/testing-stack.md +3 -0
- package/agents/api/types.md +248 -24
- package/agents/api.md +7 -7
- package/agents/boot-rules.md +66 -10
- package/agents/examples/api-docs.md +2 -6
- package/agents/examples/auth-mfa.md +57 -10
- package/agents/examples/chat-channels.md +2 -0
- package/agents/examples/crypto-shredding-hr.md +63 -1
- package/agents/examples/currencies-global.md +1 -0
- package/agents/examples/env-composition.md +7 -11
- package/agents/examples/managed-pages.md +90 -1
- package/agents/examples/pwa-shell.md +210 -0
- package/agents/examples/rate-limiting.md +3 -3
- package/agents/examples/record-detail-layout.md +1643 -67
- package/agents/examples/workflow-engine.md +16 -12
- package/agents/examples.md +1 -0
- package/agents/features-index.md +4 -2
- package/agents/features.md +22 -7
- package/agents/widgets.md +26 -1
- package/dist/api/api-constants.d.ts +1 -0
- package/dist/api/api-constants.js +4 -0
- package/dist/api/auth-middleware.js +4 -3
- package/dist/api/auth-routes-shared.js +2 -1
- package/dist/api/entity-read-access.d.ts +1 -0
- package/dist/api/entity-read-access.js +18 -0
- package/dist/api/export/export-route.d.ts +6 -1
- package/dist/api/export/export-route.js +27 -1
- package/dist/api/export/export-rows.js +19 -3
- package/dist/api/request-context-internals.d.ts +2 -0
- package/dist/api/request-context-scopes.js +9 -2
- package/dist/api/request-context.js +1 -1
- package/dist/api/routes.d.ts +2 -0
- package/dist/api/routes.js +9 -1
- package/dist/api/server-event-dispatcher.js +3 -0
- package/dist/api/server-extra-routes.js +2 -1
- package/dist/api/server-feature-http-routes.d.ts +9 -0
- package/dist/api/server-feature-http-routes.js +109 -0
- package/dist/api/server-middleware.js +2 -19
- package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
- package/dist/api/server-pat-rate-limit-guard.js +19 -0
- package/dist/api/server-rate-limit-wiring.d.ts +10 -0
- package/dist/api/server-rate-limit-wiring.js +37 -0
- package/dist/api/server-routes.d.ts +4 -12
- package/dist/api/server-routes.js +12 -171
- package/dist/api/server-schema-route.d.ts +3 -0
- package/dist/api/server-schema-route.js +58 -0
- package/dist/api/server-wiring.js +2 -37
- package/dist/api/server.js +3 -1
- package/dist/compliance/override-schema.js +5 -5
- package/dist/compliance/sub-processors.js +10 -1
- package/dist/crypto/index.d.ts +1 -1
- package/dist/crypto/index.js +1 -1
- package/dist/crypto/pii-field-encryption.d.ts +2 -0
- package/dist/crypto/pii-field-encryption.js +16 -1
- package/dist/db/apply-entity-event.js +4 -0
- package/dist/db/bun-sql-connection-codes.d.ts +1 -0
- package/dist/db/bun-sql-connection-codes.js +7 -0
- package/dist/db/collect-table-metas.js +4 -1
- package/dist/db/config-seed.js +1 -1
- package/dist/db/derived-field-sql.js +15 -13
- package/dist/db/derived-related-sql.d.ts +2 -2
- package/dist/db/derived-related-sql.js +4 -2
- package/dist/db/dialect.d.ts +3 -0
- package/dist/db/dialect.js +1 -3
- package/dist/db/driver-row-coercion.js +2 -2
- package/dist/db/driver-value-preparation.js +1 -1
- package/dist/db/eagerload.js +15 -12
- package/dist/db/entity-table-meta.d.ts +2 -0
- package/dist/db/entity-table-meta.js +7 -0
- package/dist/db/event-store-executor-context.js +13 -8
- package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
- package/dist/db/event-store-executor-read-aggregate.js +2 -2
- package/dist/db/event-store-executor-read-filter.d.ts +4 -0
- package/dist/db/event-store-executor-read-filter.js +28 -11
- package/dist/db/event-store-executor-read-search.d.ts +1 -0
- package/dist/db/event-store-executor-read-search.js +6 -6
- package/dist/db/event-store-executor-read-sort.js +3 -3
- package/dist/db/event-store-executor-read-where.js +14 -5
- package/dist/db/event-store-executor-read.js +7 -7
- package/dist/db/event-store-executor-write.js +50 -95
- package/dist/db/executor-managed-tables.js +4 -1
- package/dist/db/index.d.ts +4 -2
- package/dist/db/index.js +4 -2
- package/dist/db/known-table-names.d.ts +1 -0
- package/dist/db/known-table-names.js +7 -5
- package/dist/db/list-aggregate-labels.d.ts +1 -0
- package/dist/db/list-aggregate-labels.js +9 -1
- package/dist/db/migrate-generator.js +23 -4
- package/dist/db/migrate-rls-diff.d.ts +1 -0
- package/dist/db/migrate-rls-diff.js +15 -1
- package/dist/db/migrate-runner.js +2 -2
- package/dist/db/money.d.ts +1 -1
- package/dist/db/money.js +1 -4
- package/dist/db/parent-ref-clause.d.ts +6 -2
- package/dist/db/parent-ref-clause.js +105 -24
- package/dist/db/parent-ref-global-hosts.d.ts +23 -0
- package/dist/db/parent-ref-global-hosts.js +85 -0
- package/dist/db/production-schema-command-hint.d.ts +1 -0
- package/dist/db/production-schema-command-hint.js +3 -0
- package/dist/db/queries/backfill-pii.js +55 -29
- package/dist/db/queries/ddl.js +13 -2
- package/dist/db/queries/event-store-open-streams.d.ts +15 -0
- package/dist/db/queries/event-store-open-streams.js +33 -0
- package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
- package/dist/db/queries/event-store-payload-scrub.js +11 -0
- package/dist/db/queries/event-store.js +0 -1
- package/dist/db/queries/raw-sql.js +0 -1
- package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
- package/dist/db/queries/rebuild-rls-guard.js +24 -11
- package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
- package/dist/db/queries/rls-boot-catalog.js +13 -9
- package/dist/db/queries/rls-shape.d.ts +3 -1
- package/dist/db/queries/rls-shape.js +31 -6
- package/dist/db/queries/session-advisory-lock.js +2 -1
- package/dist/db/queries/test-stack.js +7 -7
- package/dist/db/query.js +16 -11
- package/dist/db/rebuild-marker.js +11 -2
- package/dist/db/render-rls-ddl.d.ts +2 -0
- package/dist/db/render-rls-ddl.js +16 -11
- package/dist/db/replay-migration-sql.js +1 -1
- package/dist/db/row-level-security-boot-check.js +18 -5
- package/dist/db/row-level-security-connection.js +25 -12
- package/dist/db/row-level-security-scope.d.ts +2 -1
- package/dist/db/row-level-security-scope.js +9 -5
- package/dist/db/sql-identifier.d.ts +1 -0
- package/dist/db/sql-identifier.js +3 -0
- package/dist/db/system-tenant-read-db.d.ts +5 -0
- package/dist/db/system-tenant-read-db.js +28 -0
- package/dist/db/table-builder.d.ts +3 -1
- package/dist/db/table-builder.js +18 -8
- package/dist/db/table-info.d.ts +1 -2
- package/dist/db/table-introspection.d.ts +3 -0
- package/dist/db/table-introspection.js +6 -0
- package/dist/db/table-push.d.ts +1 -0
- package/dist/db/table-push.js +7 -1
- package/dist/db/tenant-db-runner.d.ts +3 -0
- package/dist/db/tenant-db-runner.js +19 -1
- package/dist/db/transaction-serialization.d.ts +1 -0
- package/dist/db/transaction-serialization.js +20 -3
- package/dist/db/where-clause.js +11 -2
- package/dist/db/write-ownership-failures.d.ts +25 -0
- package/dist/db/write-ownership-failures.js +82 -0
- package/dist/engine/boot-validator/boot-check.js +7 -1
- package/dist/engine/boot-validator/boot-phases-app.js +5 -5
- package/dist/engine/boot-validator/boot-phases.js +3 -2
- package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
- package/dist/engine/boot-validator/boot-rules.js +4 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
- package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
- package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
- package/dist/engine/boot-validator/config-deps.d.ts +0 -1
- package/dist/engine/boot-validator/config-deps.js +0 -28
- package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
- package/dist/engine/boot-validator/config-key-rules.js +0 -15
- package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
- package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
- package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
- package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
- package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
- package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/entity-list-screens.js +35 -13
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
- package/dist/engine/boot-validator/list-column-layout.js +10 -6
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
- package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
- package/dist/engine/boot-validator/list-row-guidance.js +143 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
- package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
- package/dist/engine/boot-validator/list-sort-summary.js +160 -0
- package/dist/engine/boot-validator/list-table-options.js +15 -1
- package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
- package/dist/engine/boot-validator/list-table-rules.js +10 -5
- package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
- package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
- package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
- package/dist/engine/boot-validator/named-filter-rules.js +42 -2
- package/dist/engine/boot-validator/ownership.js +10 -1
- package/dist/engine/boot-validator/parent-ref.js +87 -50
- package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
- package/dist/engine/boot-validator/projection-list-screens.js +32 -1
- package/dist/engine/boot-validator/query-output-columns.js +62 -9
- package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/query-output-guidance.js +40 -0
- package/dist/engine/boot-validator/query-refs.js +34 -1
- package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
- package/dist/engine/boot-validator/row-decoration.js +16 -0
- package/dist/engine/boot-validator/screens-actions.js +1 -1
- package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
- package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
- package/dist/engine/boot-validator/screens-dashboard.js +29 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
- package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
- package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
- package/dist/engine/boot-validator/screens-lists.js +19 -3
- package/dist/engine/boot-validator/screens.js +1 -1
- package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
- package/dist/engine/boot-validator/sort-nulls.js +15 -0
- package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
- package/dist/engine/boot-validator/zod-shape.js +19 -1
- package/dist/engine/build-app-schema.js +4 -0
- package/dist/engine/config-helpers.d.ts +1 -2
- package/dist/engine/config-helpers.js +6 -7
- package/dist/engine/define-feature.js +1 -0
- package/dist/engine/define-handler.d.ts +1 -0
- package/dist/engine/define-handler.js +4 -2
- package/dist/engine/definition-violations.js +2 -2
- package/dist/engine/entity-handlers.js +3 -8
- package/dist/engine/entity-list-runtime-options.js +9 -8
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/feature-config-events-jobs.js +1 -0
- package/dist/engine/feature-entity-handlers.js +5 -2
- package/dist/engine/field-access.d.ts +1 -1
- package/dist/engine/field-access.js +7 -10
- package/dist/engine/find-entity.js +3 -3
- package/dist/engine/form-derivations.js +3 -3
- package/dist/engine/index.d.ts +3 -3
- package/dist/engine/index.js +2 -2
- package/dist/engine/named-filter-roles.d.ts +3 -0
- package/dist/engine/named-filter-roles.js +15 -0
- package/dist/engine/pipeline.js +0 -1
- package/dist/engine/project-app-schema-for-roles.js +17 -2
- package/dist/engine/qualified-name.js +0 -1
- package/dist/engine/registry-facade.js +1 -2
- package/dist/engine/registry-state.d.ts +1 -1
- package/dist/engine/registry-state.js +5 -2
- package/dist/engine/registry-validate.js +2 -1
- package/dist/engine/resolve-named-list-filters.js +5 -2
- package/dist/engine/schema-builder.js +9 -11
- package/dist/engine/screen-helpers.d.ts +12 -0
- package/dist/engine/screen-helpers.js +17 -1
- package/dist/engine/soft-delete-cleanup.js +3 -5
- package/dist/engine/state-machine.js +0 -1
- package/dist/engine/steps/_database-clock.d.ts +2 -0
- package/dist/engine/steps/_database-clock.js +6 -0
- package/dist/engine/steps/compute.js +1 -1
- package/dist/engine/steps/retry.js +5 -1
- package/dist/engine/steps/return.js +0 -1
- package/dist/engine/steps/wait-for-event.js +2 -1
- package/dist/engine/steps/wait.js +2 -1
- package/dist/engine/system-user.d.ts +2 -2
- package/dist/engine/system-user.js +2 -2
- package/dist/engine/types/handlers.d.ts +1 -1
- package/dist/engine/types/handlers.js +1 -1
- package/dist/engine/types/screen.d.ts +1 -1
- package/dist/engine/types/screen.js +1 -1
- package/dist/engine/webhook-contracts.d.ts +2 -3
- package/dist/engine/webhook-contracts.js +2 -25
- package/dist/engine/webhook-events.js +48 -29
- package/dist/engine/webhook-payload-strictness.d.ts +7 -0
- package/dist/engine/webhook-payload-strictness.js +53 -0
- package/dist/env/_zod-introspect.d.ts +1 -0
- package/dist/env/dry-run.d.ts +1 -1
- package/dist/env/dry-run.js +1 -1
- package/dist/env/field-meta.d.ts +4 -0
- package/dist/env/field-meta.js +67 -0
- package/dist/env/field-rules.d.ts +9 -0
- package/dist/env/field-rules.js +46 -0
- package/dist/env/index.d.ts +3 -3
- package/dist/env/index.js +16 -71
- package/dist/env/internals.d.ts +3 -0
- package/dist/env/internals.js +1 -2
- package/dist/env/required-env.d.ts +3 -1
- package/dist/env/required-env.js +5 -2
- package/dist/errors/reasons.d.ts +1 -0
- package/dist/errors/reasons.js +4 -0
- package/dist/errors/serialize.js +2 -2
- package/dist/errors/write-error-info.js +0 -2
- package/dist/es-ops/operations-schema.js +18 -7
- package/dist/event-store/admin-api.js +3 -3
- package/dist/event-store/event-store.js +0 -3
- package/dist/event-store/index.d.ts +1 -0
- package/dist/event-store/index.js +1 -0
- package/dist/event-store/transfer.js +1 -1
- package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
- package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
- package/dist/files/bind-pending-file-refs.d.ts +3 -1
- package/dist/files/bind-pending-file-refs.js +54 -27
- package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
- package/dist/files/create-file-ref.d.ts +4 -1
- package/dist/files/create-file-ref.js +14 -3
- package/dist/files/default-file-guard.js +4 -1
- package/dist/files/file-claim.d.ts +6 -0
- package/dist/files/file-claim.js +17 -0
- package/dist/files/file-field-slots.d.ts +2 -0
- package/dist/files/file-field-slots.js +28 -0
- package/dist/files/file-ref-entity.d.ts +3 -0
- package/dist/files/file-ref-entity.js +2 -0
- package/dist/files/file-ref-table.d.ts +3 -0
- package/dist/files/file-routes.d.ts +4 -1
- package/dist/files/file-routes.js +80 -16
- package/dist/files/in-memory-provider.d.ts +1 -1
- package/dist/files/in-memory-provider.js +2 -1
- package/dist/files/index.d.ts +1 -1
- package/dist/files/index.js +1 -1
- package/dist/files/invalid-file-ref-error.d.ts +2 -0
- package/dist/files/invalid-file-ref-error.js +15 -0
- package/dist/files/local-provider.js +9 -2
- package/dist/files/provider-resolver.js +1 -1
- package/dist/files/rebind-file-ref.d.ts +3 -2
- package/dist/files/rebind-file-ref.js +24 -18
- package/dist/files/resolve-file-handles.d.ts +13 -0
- package/dist/files/resolve-file-handles.js +57 -0
- package/dist/files/storage-tracking.d.ts +1 -1
- package/dist/files/storage-tracking.js +5 -2
- package/dist/files/sweep-stale-pending-file-refs.js +10 -4
- package/dist/files/types.d.ts +4 -0
- package/dist/files/types.js +10 -0
- package/dist/files/upload-field-resolution.d.ts +1 -0
- package/dist/files/upload-field-resolution.js +16 -2
- package/dist/files/upload-ledger.js +1 -1
- package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
- package/dist/i18n/required-surface-guidance-keys.js +9 -0
- package/dist/i18n/required-surface-keys.js +21 -5
- package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
- package/dist/internal/boot-rule-table-expectations.js +29 -0
- package/dist/internal/row-level-security.d.ts +1 -0
- package/dist/internal/row-level-security.js +1 -0
- package/dist/internal/testing.d.ts +1 -0
- package/dist/internal/testing.js +1 -0
- package/dist/jobs/index.d.ts +1 -0
- package/dist/jobs/index.js +1 -0
- package/dist/jobs/job-load-events.d.ts +10 -0
- package/dist/jobs/job-load-events.js +12 -0
- package/dist/jobs/job-runner-context.js +6 -158
- package/dist/jobs/job-runner-dispatch.d.ts +7 -0
- package/dist/jobs/job-runner-dispatch.js +57 -0
- package/dist/jobs/job-runner-event-triggers.js +18 -9
- package/dist/jobs/job-runner-execution.js +5 -2
- package/dist/jobs/job-runner-facets.d.ts +48 -0
- package/dist/jobs/job-runner-facets.js +156 -0
- package/dist/jobs/job-runner-gates.js +19 -11
- package/dist/jobs/job-runner-helpers.d.ts +5 -1
- package/dist/jobs/job-runner-helpers.js +18 -3
- package/dist/jobs/job-runner-scope.d.ts +1 -0
- package/dist/jobs/job-runner-scope.js +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
- package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
- package/dist/jobs/job-runner-types.d.ts +1 -0
- package/dist/jobs/job-runner.js +39 -70
- package/dist/jobs/obliterate-job-queues.d.ts +6 -0
- package/dist/jobs/obliterate-job-queues.js +23 -0
- package/dist/lifecycle/lifecycle.js +1 -1
- package/dist/migrations/event-header-scrub.d.ts +11 -0
- package/dist/migrations/event-header-scrub.js +33 -0
- package/dist/migrations/event-payload-scrub.d.ts +1 -1
- package/dist/migrations/event-payload-scrub.js +36 -4
- package/dist/migrations/index.d.ts +1 -0
- package/dist/migrations/index.js +2 -0
- package/dist/migrations/kumiko-drift.d.ts +5 -2
- package/dist/migrations/kumiko-drift.js +51 -14
- package/dist/migrations/pending-rebuilds.js +4 -5
- package/dist/observability/sensitive-filter.js +0 -12
- package/dist/pipeline/aggregate-type-removal.js +17 -4
- package/dist/pipeline/context-services.d.ts +2 -0
- package/dist/pipeline/context-services.js +5 -2
- package/dist/pipeline/dispatch-batch.js +4 -3
- package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
- package/dist/pipeline/dispatch-context-helpers.js +58 -0
- package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
- package/dist/pipeline/dispatch-nested-write.js +119 -0
- package/dist/pipeline/dispatch-query.js +10 -3
- package/dist/pipeline/dispatch-scope.js +4 -3
- package/dist/pipeline/dispatch-shared.d.ts +2 -6
- package/dist/pipeline/dispatch-shared.js +6 -38
- package/dist/pipeline/dispatch-write.d.ts +0 -1
- package/dist/pipeline/dispatch-write.js +3 -302
- package/dist/pipeline/dispatcher-utils.js +6 -0
- package/dist/pipeline/effective-system-scope.d.ts +3 -0
- package/dist/pipeline/effective-system-scope.js +22 -0
- package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
- package/dist/pipeline/event-dispatcher-delivery.js +20 -9
- package/dist/pipeline/event-dispatcher.d.ts +6 -1
- package/dist/pipeline/event-dispatcher.js +6 -7
- package/dist/pipeline/handler-context-auth.d.ts +3 -2
- package/dist/pipeline/handler-context-auth.js +3 -4
- package/dist/pipeline/handler-context-db.js +11 -4
- package/dist/pipeline/handler-context-dispatch.js +2 -2
- package/dist/pipeline/handler-context-events.d.ts +8 -3
- package/dist/pipeline/handler-context-events.js +20 -65
- package/dist/pipeline/handler-context-member-resolution.js +16 -8
- package/dist/pipeline/handler-context-notify.d.ts +1 -0
- package/dist/pipeline/handler-context-notify.js +2 -0
- package/dist/pipeline/handler-context-phase-denials.js +3 -2
- package/dist/pipeline/handler-context-projection.d.ts +3 -0
- package/dist/pipeline/handler-context-projection.js +39 -0
- package/dist/pipeline/handler-context-scope.d.ts +1 -1
- package/dist/pipeline/handler-context-scope.js +14 -2
- package/dist/pipeline/index.d.ts +1 -1
- package/dist/pipeline/index.js +1 -1
- package/dist/pipeline/irreversible-operation-gate.js +36 -10
- package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
- package/dist/pipeline/lifecycle-pipeline.js +7 -4
- package/dist/pipeline/member-reader.js +4 -2
- package/dist/pipeline/msp-rebuild.js +1 -1
- package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
- package/dist/pipeline/nested-write-parent-guard.js +81 -0
- package/dist/pipeline/projection-rebuild.d.ts +2 -0
- package/dist/pipeline/projection-rebuild.js +16 -7
- package/dist/pipeline/projection-state.js +4 -6
- package/dist/pipeline/system-hooks.js +36 -6
- package/dist/pipeline/write-result-masking.js +31 -3
- package/dist/pipeline/write-transition-guard.d.ts +7 -0
- package/dist/pipeline/write-transition-guard.js +95 -0
- package/dist/schema-cli/shared.d.ts +2 -0
- package/dist/schema-cli/shared.js +4 -2
- package/dist/schema-cli/validate-command.js +43 -28
- package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
- package/dist/search/meilisearch-adapter-internals.js +5 -0
- package/dist/search/meilisearch-adapter.d.ts +1 -0
- package/dist/search/meilisearch-adapter.js +17 -11
- package/dist/search/reindex-entity.d.ts +2 -0
- package/dist/search/reindex-entity.js +32 -4
- package/dist/search/reindex-tenants-search.js +20 -4
- package/dist/time/tz-context.js +1 -1
- package/dist/ui-types/card-column-roles.d.ts +6 -0
- package/dist/ui-types/card-column-roles.js +21 -3
- package/dist/ui-types/index.d.ts +3 -3
- package/dist/ui-types/index.js +2 -2
- package/dist/utils/ids.js +0 -1
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +1 -0
- package/dist/utils/return-path-limit.d.ts +1 -0
- package/dist/utils/return-path-limit.js +1 -0
- package/package.json +5 -3
- package/presets/biome-app.json +39 -21
- package/presets/biome-plugins/admin-api.grit +10 -0
- package/presets/biome-plugins/error-reasons.grit +53 -0
- package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
- package/presets/biome-plugins/es-literal-writes.grit +22 -0
- package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
- package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
- package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
- package/presets/biome-plugins/no-css-properties-type.grit +7 -0
- package/presets/biome-plugins/no-date-api.grit +11 -0
- package/presets/biome-plugins/no-direct-fetch.grit +16 -0
- package/presets/biome-plugins/no-direct-fs.grit +16 -0
- package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
- package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
- package/presets/biome-plugins/no-raw-hooks.grit +10 -0
- package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
- package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
- package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
- package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
- package/presets/biome-plugins/raw-html-in-web.grit +40 -0
- package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
- package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
- package/presets/biome-plugins/test-title.grit +20 -0
- package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
- package/presets/biome-rules.json +467 -0
- package/src/changes.json +366 -0
- package/dist/engine/minor-units.d.ts +0 -2
- package/dist/engine/minor-units.js +0 -8
|
@@ -10,6 +10,7 @@ Import from `@cosmicdrift/kumiko-framework/ui-types`. Types used here but not ex
|
|
|
10
10
|
function applyFormDerivations(values: unknown, screen: FormDerivationScreen): unknown; // Recomputes every derived head field of an action form from its inputs.
|
|
11
11
|
function availableSelectOptions(field: SelectOptionRules, values: Record<string, unknown>): string[]; // Options of a select field that are offered for the given row values, in declaration order.
|
|
12
12
|
function cardColumnRoles<C extends CardRoleColumn>(columns: C[]): CardColumnRoles<C>;
|
|
13
|
+
function cardMetaLines<C extends CardRoleColumn>(meta: C[]): (C[])[];
|
|
13
14
|
function computeDerivedCellValue(op: NumericDerivedOp, values: (number | undefined)[]): number | undefined; // Computes a derived cell from its source values.
|
|
14
15
|
function evalFieldCondition(cond: FieldCondition, values: Record<string, unknown>): boolean; // Evaluates a declarative FieldCondition against the current row/form values.
|
|
15
16
|
function findMissingConditionalRequirements(fields: Readonly<Record<string, FieldDefinition>>, values: Record<string, unknown>, previous?: Record<string, unknown>): string[]; // Paths of fields (and embedded sub-fields) whose `requiredWhen` holds while the value is missing.
|
|
@@ -23,9 +24,9 @@ function isFormatSpec(r: unknown): r is FormatSpec;
|
|
|
23
24
|
function isMissingRequiredValue(value: unknown): boolean;
|
|
24
25
|
function isRecordLocked(lockedWhen: FieldCondition | undefined, row: Readonly<Record<string, unknown>>): boolean;
|
|
25
26
|
function isUiAccessGranted(access: AccessRule | undefined, userRoles: string[] | undefined): boolean;
|
|
26
|
-
function isUnchangedValue(a: unknown, b: unknown): boolean;
|
|
27
27
|
function isUnusedFallbackOperand(screen: FormDerivationScreen, values: unknown, field: string): boolean; // True when `field` is only read as a `whenEmpty` operand of `listSum` derivations whose lists all have rows: nothing reads it, so it is locked rather than inviting an input that is silently dropped.
|
|
28
28
|
function isWriteFormEditSection(section: EditSectionSpec): section is EditWriteFormSection;
|
|
29
|
+
function pickEmptyStateText<Variant extends EmptyStateText & { when: FieldCondition; }, EmptyState extends EmptyStateText & { variants?: Variant[]; }>(emptyState: EmptyState | undefined, record: Readonly<Record<string, unknown>>): EmptyState | Variant | undefined; // Picks the first emptyState variant whose `when` matches the record, else the base emptyState.
|
|
29
30
|
function resolveNavParentScreen(screens: ScreenDefinition[], detail: ScreenDefinition, getId: (screen: ScreenDefinition) => string): ScreenDefinition | undefined;
|
|
30
31
|
function resolveTranslationValue(value: TranslationValue, locale: string, params?: Readonly<Record<string, unknown>>): string; // Resolve a TranslationValue to display text: a plural entry picks its CLDR category via `Intl.PluralRules` from `params.count`, falling back to `other` when `count` is missing, non-finite, or `locale` is invalid.
|
|
31
32
|
function roundDerivedCellValue(value: number, target: DerivedCellRoundingTarget): number; // Rounds a derived cell's computed value to the precision its target sub-field declares — commercial rounding (round-half-away-from-zero, correct for signed minor-unit money).
|
|
@@ -116,7 +117,7 @@ type DashboardChartMarkerKind = { // Look of the markers whose `kind` matches: a
|
|
|
116
117
|
color?: string;
|
|
117
118
|
label?: string; // i18n key; with `markerLegend: "legend"` the chart legend lists the markers of this kind under it.
|
|
118
119
|
};
|
|
119
|
-
type DashboardChartPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & {
|
|
120
|
+
type DashboardChartPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & DashboardPanelNarrow & {
|
|
120
121
|
kind: "chart";
|
|
121
122
|
id: string;
|
|
122
123
|
label: string;
|
|
@@ -146,7 +147,7 @@ type DashboardDateParam = { // Epoch ms, rendered as a medium date in the user t
|
|
|
146
147
|
kind: "date";
|
|
147
148
|
atMs: number;
|
|
148
149
|
};
|
|
149
|
-
type DashboardFeedPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & {
|
|
150
|
+
type DashboardFeedPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & DashboardPanelNarrow & {
|
|
150
151
|
kind: "feed";
|
|
151
152
|
id: string;
|
|
152
153
|
label: string;
|
|
@@ -161,13 +162,39 @@ type DashboardFilterDefinition = {
|
|
|
161
162
|
options?: { value: string; label: string; }[];
|
|
162
163
|
optionsQuery?: string; // Query-Result-Contract: `{ rows: { value: string; label: string }[] }`.
|
|
163
164
|
};
|
|
164
|
-
type
|
|
165
|
+
type DashboardListFooterLink = { // Link to a screen from a panel; `label` is an i18n key, `namedFilter` only for list screens.
|
|
166
|
+
label: string;
|
|
167
|
+
moreText?: string; // i18n key of the text before the link when more rows exist than shown; `{count}` is the rest.
|
|
168
|
+
narrowMoreText?: string; // i18n key used instead of `moreText` below `sm`.
|
|
169
|
+
narrowOnly?: boolean; // Draw the link only below `sm`, where it is the target of the "line" layout; from `sm` up the panel shows no footer link.
|
|
170
|
+
screen: string;
|
|
171
|
+
namedFilter?: string;
|
|
172
|
+
params?: Readonly<Record<string, string>>;
|
|
173
|
+
};
|
|
174
|
+
type DashboardListNarrow = { // "cards": one card per row (tone stripe; badge column and `hint.detailField` on top, the hint sentence bold, button column bottom right, `showOnNarrowOnly` columns bottom left; the button column bottom right).
|
|
175
|
+
limit?: number;
|
|
176
|
+
layout?: "cards" | "line";
|
|
177
|
+
field?: string; // Query output field whose value of the first row stands behind the label in the "line" layout; it need not be a column of the panel.
|
|
178
|
+
moreText?: string; // i18n key replacing "k more" in the "line" layout; `{count}` is the total minus the first row.
|
|
179
|
+
titleField?: string; // Row field replacing the card title (the hint sentence) in the "cards" layout, e.g. a shorter sentence for the phone.
|
|
180
|
+
};
|
|
181
|
+
type DashboardListPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & DashboardPanelNarrow & {
|
|
165
182
|
kind: "list";
|
|
166
183
|
id: string;
|
|
167
184
|
label: string;
|
|
168
185
|
query: string;
|
|
169
186
|
columns: ListColumnSpec[];
|
|
170
|
-
|
|
187
|
+
rowToneField?: string; // Row field holding a SelectOptionTone; tints the row and is the default tone of `hint` columns.
|
|
188
|
+
rowToneMarker?: DashboardListRowToneMarker; // How `rowToneField` marks a table row from `sm` up: "bar" (default) draws a stripe at the left edge, "dot" a small dot in front of the first cell.
|
|
189
|
+
icon?: PlatformComponent; // Icon left of the one-line phone variant (`narrow.layout: "line"`); not drawn from `sm` up.
|
|
190
|
+
showHeader?: boolean; // `false` drops the column header row; default true.
|
|
191
|
+
subtitle?: string; // i18n key, a line under `label`; with `showTotal` it stands before the count.
|
|
192
|
+
showTotal?: true | DashboardListShowTotal; // Adds "n of m" to the subtitle from the rows shown and the query's `total`.
|
|
193
|
+
footerLink?: DashboardListFooterLink; // Link under the table to the full list; with a known `total` above the rows shown, "k more" stands before it.
|
|
194
|
+
narrow?: DashboardListNarrow; // Phone layout below `sm`; the table stays from `sm` up.
|
|
195
|
+
rowLink?: DashboardListRowLink; // Makes each table row a link to a screen; a small icon at the right edge marks it.
|
|
196
|
+
};
|
|
197
|
+
type DashboardListRowToneMarker = "bar" | "dot"; // "bar": stripe at the left edge of the row.
|
|
171
198
|
type DashboardMoneyParam = { // Minor units (like Money fields), formatted with the user locale.
|
|
172
199
|
kind: "money";
|
|
173
200
|
amountMinor: number;
|
|
@@ -179,17 +206,21 @@ type DashboardPanelEmptyState = {
|
|
|
179
206
|
emptyLabel?: string;
|
|
180
207
|
emptyHint?: string; // Second line under `emptyLabel`.
|
|
181
208
|
};
|
|
209
|
+
type DashboardPanelNarrow = { // Phone layout switch shared by every panel kind.
|
|
210
|
+
hideOnNarrow?: true; // Leaves the panel out below the `sm` breakpoint (phone).
|
|
211
|
+
narrowOrder?: number; // Position below `sm`, like CSS `order`: panels are laid out by ascending value, a panel without one counts as 0, equal values keep the declared order.
|
|
212
|
+
};
|
|
182
213
|
type DashboardPanelQueryOptions = {
|
|
183
214
|
params?: Readonly<Record<string, unknown>>; // Static, author-set query parameters merged on top of the screen's dynamic filterParams — lets a panel pin a value (e.g. a status facet) the screen-wide filter doesn't cover, without needing its own query.
|
|
184
215
|
ignoreScreenFilter?: boolean; // The screen `filter` value is NOT merged into this panel's query (a tenant picker must not hit sources without a tenant column).
|
|
185
216
|
};
|
|
186
|
-
type DashboardPanelSpan = "half" | "full";
|
|
217
|
+
type DashboardPanelSpan = "half" | "full" | "third" | "two-thirds";
|
|
187
218
|
type DashboardPanelVisibility = {
|
|
188
219
|
query: string;
|
|
189
220
|
field: string;
|
|
190
221
|
eq: string | number | boolean | null;
|
|
191
222
|
};
|
|
192
|
-
type DashboardProgressListPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & {
|
|
223
|
+
type DashboardProgressListPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & DashboardPanelNarrow & {
|
|
193
224
|
kind: "progress-list";
|
|
194
225
|
id: string;
|
|
195
226
|
label: string;
|
|
@@ -229,11 +260,11 @@ type DashboardScreenDefinition = {
|
|
|
229
260
|
filter?: DashboardFilterDefinition;
|
|
230
261
|
timeRange?: DashboardTimeRangeDefinition; // Segmented control in the toolbar; the value lives in URL search param `id` and is merged into EVERY panel query (also ignoreScreenFilter ones).
|
|
231
262
|
scope?: DashboardScopeDefinition; // Marks the screen as spanning more than the caller's own scope.
|
|
232
|
-
showUpdatedAt?: boolean; // Show
|
|
263
|
+
showUpdatedAt?: boolean; // Show today's date (server clock, weekday and day, no time) in the top bar next to the title; hidden below `sm`.
|
|
233
264
|
slots?: ScreenSlots;
|
|
234
265
|
access?: AccessRule;
|
|
235
266
|
};
|
|
236
|
-
type DashboardScreenPanel = {
|
|
267
|
+
type DashboardScreenPanel = DashboardPanelNarrow & {
|
|
237
268
|
kind: "screen";
|
|
238
269
|
id: string;
|
|
239
270
|
screen: string; // Same-feature short id or cross-feature QN `<feature>:screen:<id>`.
|
|
@@ -242,20 +273,36 @@ type DashboardScreenPanel = {
|
|
|
242
273
|
fallback?: string; // Same-feature short id or cross-feature QN `<feature>:screen:<id>` embedded in this panel's place when `visibleWhen` is unmet or its query fails (nothing while it loads).
|
|
243
274
|
chromeless?: boolean; // Render the embedded form without its own card frame and padding, aligned to the dashboard's page grid like a standalone settings screen.
|
|
244
275
|
};
|
|
245
|
-
type
|
|
276
|
+
type DashboardStatGroupLayout = "cards" | "strip";
|
|
277
|
+
type DashboardStatGroupLink = { // Link at the right edge of a stat-group panel; `label` is an i18n key.
|
|
278
|
+
label: string;
|
|
279
|
+
screen: string;
|
|
280
|
+
params?: Readonly<Record<string, string>>;
|
|
281
|
+
};
|
|
282
|
+
type DashboardStatGroupNarrow = {
|
|
283
|
+
tone?: SelectOptionTone; // Tints the one-line phone strip (background and border) in this tone, e.g. "accent" for a promo-blue inbox line.
|
|
284
|
+
};
|
|
285
|
+
type DashboardStatGroupPanel = DashboardPanelGate & DashboardPanelNarrow & {
|
|
246
286
|
kind: "stat-group";
|
|
247
287
|
id: string;
|
|
248
288
|
label?: string;
|
|
249
289
|
subtitle?: string; // i18n key, a line under `label`; the boot validator requires `label`.
|
|
250
290
|
span?: DashboardPanelSpan;
|
|
291
|
+
layout?: DashboardStatGroupLayout; // Default: "strip" without `label`, "cards" with.
|
|
292
|
+
icon?: PlatformComponent; // Icon left of the one-line phone strip (below `sm`); not drawn on wider screens.
|
|
293
|
+
link?: DashboardStatGroupLink; // Link at the right edge of the panel (label + chevron).
|
|
294
|
+
narrow?: DashboardStatGroupNarrow; // Phone look of the one-line strip; needs a label and layout "strip".
|
|
295
|
+
columns?: 2 | 3 | 4; // Tiles per row from `md` up, only with `layout: "cards"`; one column below `sm`.
|
|
251
296
|
stats: DashboardStatPanel[];
|
|
252
297
|
};
|
|
253
|
-
type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate & {
|
|
298
|
+
type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate & DashboardPanelNarrow & {
|
|
254
299
|
kind: "stat";
|
|
255
300
|
id: string; // Stable id: kebab-case, unique within the panel set.
|
|
256
301
|
label: string; // Display text (i18n key).
|
|
257
302
|
query: string;
|
|
258
303
|
valueField: string;
|
|
304
|
+
labelField?: string; // Field of the query answer holding the label text, e.g. "Contracts ending by 31.01.2027"; it replaces the static `label` while it holds a non-empty string.
|
|
305
|
+
narrowLabel?: string; // i18n key shown instead of the label in the one-line phone strip of a titled stat-group ("2 requests").
|
|
259
306
|
subField?: string;
|
|
260
307
|
toneField?: string;
|
|
261
308
|
valueFormat?: DashboardValueFormat; // Formats a numeric value as currency (minor units) or, with `relativeTime`, as a ticking "5 minutes ago" from epoch ms; ignored for string values.
|
|
@@ -269,22 +316,23 @@ type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate & {
|
|
|
269
316
|
navigate?: {
|
|
270
317
|
screen: string;
|
|
271
318
|
namedFilter?: string;
|
|
319
|
+
params?: Readonly<Record<string, string>>; // Search params for the target list, e.g. { tab: "failed" }; merged with the namedFilter param.
|
|
272
320
|
}; // Makes the tile a link to a list screen (qualified screen id).
|
|
273
321
|
};
|
|
274
322
|
type DashboardText = string | DashboardI18nText; // Plain string is displayed as-is; DashboardI18nText is translated by the renderer.
|
|
275
323
|
type DashboardTextBlock =
|
|
276
324
|
| {
|
|
277
325
|
kind: "heading";
|
|
278
|
-
text:
|
|
326
|
+
text: DashboardText;
|
|
279
327
|
}
|
|
280
328
|
| {
|
|
281
329
|
kind: "paragraph";
|
|
282
|
-
text:
|
|
283
|
-
emphasis?: "muted" | "strong"; // Default "muted", like body copy inside panels.
|
|
330
|
+
text: DashboardText;
|
|
331
|
+
emphasis?: "muted" | "strong" | "lead"; // Default "muted", like body copy inside panels.
|
|
284
332
|
}
|
|
285
333
|
| {
|
|
286
334
|
kind: "list";
|
|
287
|
-
items:
|
|
335
|
+
items: DashboardText[];
|
|
288
336
|
}
|
|
289
337
|
| {
|
|
290
338
|
kind: "code";
|
|
@@ -292,21 +340,23 @@ type DashboardTextBlock =
|
|
|
292
340
|
}
|
|
293
341
|
| {
|
|
294
342
|
kind: "hint";
|
|
295
|
-
text:
|
|
343
|
+
text: DashboardText;
|
|
296
344
|
}
|
|
297
345
|
| {
|
|
298
346
|
kind: "link";
|
|
299
|
-
text:
|
|
347
|
+
text: DashboardText; // Link label (i18n key or DashboardI18nText).
|
|
300
348
|
screen: string; // Same-feature short id or cross-feature QN `<feature>:screen:<id>`.
|
|
301
349
|
roles?: string[]; // Show the link only to users holding one of these roles.
|
|
302
350
|
}
|
|
303
351
|
;
|
|
304
|
-
type DashboardTextPanel = DashboardPanelGate & {
|
|
352
|
+
type DashboardTextPanel = DashboardPanelGate & DashboardPanelQueryOptions & DashboardPanelNarrow & {
|
|
305
353
|
kind: "text";
|
|
306
354
|
id: string;
|
|
307
355
|
label?: string; // Panel title (i18n key).
|
|
308
356
|
span?: DashboardPanelSpan;
|
|
309
|
-
blocks: DashboardTextBlock[]
|
|
357
|
+
query?: string; // Query answering `{ blocks: DashboardTextBlock[] }`; its blocks replace the static ones.
|
|
358
|
+
blocks?: DashboardTextBlock[];
|
|
359
|
+
narrowBlocks?: DashboardTextBlock[]; // Shown instead of `blocks` below `sm`; a query answering `{ blocks, narrowBlocks }` replaces both.
|
|
310
360
|
};
|
|
311
361
|
type DashboardTextParam = string | number | DashboardI18nText | DashboardMoneyParam | DashboardDateParam | DashboardRelativeTimeParam; // Nested DashboardI18nText params resolve first (e.g. a duration "{years} {months}" with one plural key each); numbers stay raw so plural rules can read `count`.
|
|
312
362
|
type DashboardTimeRangeDefinition = {
|
|
@@ -378,6 +428,7 @@ type EntityListFacetConfig = {
|
|
|
378
428
|
showCounts?: boolean; // Chips show how many rows each option matches (other facets and the search apply).
|
|
379
429
|
hideEmpty?: boolean; // Chips with zero matching rows are not shown.
|
|
380
430
|
extraOptions?: EntityListFacetExtraOption[];
|
|
431
|
+
narrowPlacement?: "behind-filter"; // "behind-filter": the facet opens behind the filter icon next to the search field instead of standing as a pill.
|
|
381
432
|
};
|
|
382
433
|
type FeatureSchema = {
|
|
383
434
|
featureName: string;
|
|
@@ -416,15 +467,38 @@ type ListBulkAction = { // An action that runs a writeHandler row action once pe
|
|
|
416
467
|
rowAction: string; // Id of a writeHandler entry in the same screen's `rowActions`; it supplies handler, payload, label, style and `visible`.
|
|
417
468
|
confirm?: string; // i18n key of the one confirm dialog for the whole selection; gets `{count}` and `{action}`.
|
|
418
469
|
};
|
|
470
|
+
type ListColumnHint = {
|
|
471
|
+
detailField?: string; // Row field with a second, muted line (e.g. the due date as text).
|
|
472
|
+
narrowDetailField?: string; // Row field shown as the detail line below `sm` instead of `detailField` (a shorter line, e.g. "5 days · Anna Schneider").
|
|
473
|
+
narrowField?: string; // Row field shown as the sentence on the phone card instead of the column's own value (a shorter sentence); the table keeps the column value.
|
|
474
|
+
toneField?: string; // Row field holding a SelectOptionTone; defaults to the screen's `rowToneField`.
|
|
475
|
+
reasonField?: string; // Row field with a longer reason, shown behind a "Why?" toggle in the cell.
|
|
476
|
+
reasonOpenField?: string; // Row field (boolean): while true, the `reasonField` text stands open as a box under the row, over the full row width, in the table view (entity/projection lists from `md` up, dashboard lists from `sm` up); the (i) stays and closes it.
|
|
477
|
+
reasonTitleField?: string; // Row field with a bold lead-in of the reason paragraph ("Rule 10 · Case open."); without it the reason has none.
|
|
478
|
+
emptyLabel?: string; // i18n key for an empty sentence; default `kumiko.list.hint.empty`.
|
|
479
|
+
plainSentence?: true; // The sentence keeps the normal text color (still bold); the tone stays on the row stripe, a badge and the detail line.
|
|
480
|
+
};
|
|
419
481
|
type ListEmptyStateSpec = { // Replacement for the default "no rows" box of a list.
|
|
420
482
|
title: string;
|
|
421
483
|
description?: string;
|
|
422
484
|
action?: RowAction;
|
|
423
485
|
};
|
|
486
|
+
type ListRowDecoration = { // Computed fields for the loaded rows: `query` calls with `{ ...params, ids }`, answering `{ rows: [{ id, ...fields }] }`.
|
|
487
|
+
query: string;
|
|
488
|
+
params?: Readonly<Record<string, unknown>>;
|
|
489
|
+
};
|
|
490
|
+
type ListSortOption = ListSortSpec & { // One entry of a list's "Sorted by" select; `label` is an i18n key.
|
|
491
|
+
label: string;
|
|
492
|
+
};
|
|
424
493
|
type ListSortSpec = {
|
|
425
494
|
field: string;
|
|
426
495
|
dir: ListSortDir;
|
|
427
496
|
};
|
|
497
|
+
type ListTableSummaryRow = { // The query receives the list's current search, filters and named filter (no paging, no sort) plus `params`, and answers `{ items: [{ label?, value, tone?, column?
|
|
498
|
+
query: string; // Qualified query name, e.g. `feature:query:order:summary`.
|
|
499
|
+
params?: Readonly<Record<string, unknown>>; // Extra payload keys merged over the list's own.
|
|
500
|
+
};
|
|
501
|
+
type ListToolbarActionsPlacement = (typeof LIST_TOOLBAR_ACTIONS_PLACEMENTS)[number];
|
|
428
502
|
type OptionsQueryPayload = Readonly<Record<string, OptionsQueryPayloadValue>>;
|
|
429
503
|
type ParsedRefTarget = {
|
|
430
504
|
featureName: string;
|
|
@@ -437,14 +511,77 @@ type PlatformComponent = {
|
|
|
437
511
|
type QualifiedContentCollection = ContentCollectionDefinition & {
|
|
438
512
|
navQn: string;
|
|
439
513
|
};
|
|
514
|
+
type RecordBannerSpec = {
|
|
515
|
+
field: string; // Holds `RecordNotice | null`; null shows no banner.
|
|
516
|
+
actions?: RecordGuidanceAction[];
|
|
517
|
+
};
|
|
518
|
+
type RecordBreadcrumbItem = {
|
|
519
|
+
label: string;
|
|
520
|
+
entity?: string; // With `id`, the item links to that record's detail screen when the user may open it.
|
|
521
|
+
id?: string;
|
|
522
|
+
};
|
|
523
|
+
type RecordBreadcrumbSpec = { // Path above the header; `field` holds `RecordBreadcrumbItem[]`.
|
|
524
|
+
field: string;
|
|
525
|
+
};
|
|
440
526
|
type RecordHeaderSubtitlePart =
|
|
441
527
|
| string
|
|
442
528
|
| {
|
|
443
529
|
field: string;
|
|
444
530
|
navigate?: MetricNavigate;
|
|
445
531
|
format?: FormatSpec; // Formats the raw field value (e.g. `timestamp`); an empty value is still dropped.
|
|
532
|
+
prefix?: string; // i18n key of a text before the value ("Owner "); it stays plain text, a `navigate` link covers only the value.
|
|
446
533
|
}
|
|
447
534
|
;
|
|
535
|
+
type RecordNotice = {
|
|
536
|
+
title: string;
|
|
537
|
+
text?: string;
|
|
538
|
+
narrowTitle?: string; // Shown instead of `title` below `sm`.
|
|
539
|
+
narrowText?: string; // Shown instead of `text` below `sm`.
|
|
540
|
+
tone?: SelectOptionTone;
|
|
541
|
+
[field: string]: unknown;
|
|
542
|
+
};
|
|
543
|
+
type RecordProgress = { // A process chain the record is part of.
|
|
544
|
+
title: string;
|
|
545
|
+
steps: RecordProgressStep[];
|
|
546
|
+
currentIndex: number;
|
|
547
|
+
};
|
|
548
|
+
type RecordProgressSpec = {
|
|
549
|
+
field: string; // Holds `RecordProgress[]`; an empty array shows no block.
|
|
550
|
+
placement?: "beside-steps"; // "beside-steps": the chains sit as a vertical stage list in a 4/12 column next to the steps panel (8/12) from lg, stacked below it under lg.
|
|
551
|
+
hideOnNarrow?: true; // Leaves the chains out below `sm`.
|
|
552
|
+
};
|
|
553
|
+
type RecordProgressStep = {
|
|
554
|
+
id: string;
|
|
555
|
+
label: string;
|
|
556
|
+
done: boolean;
|
|
557
|
+
detail?: string;
|
|
558
|
+
};
|
|
559
|
+
type RecordStep = {
|
|
560
|
+
id: string;
|
|
561
|
+
title: string;
|
|
562
|
+
narrowTitle?: string; // Shown instead of `title` below `sm`.
|
|
563
|
+
detail?: string;
|
|
564
|
+
narrowDetail?: string; // Shown instead of `detail` below `sm`.
|
|
565
|
+
tone?: SelectOptionTone;
|
|
566
|
+
why?: string; // Explanation behind a toggle next to the step.
|
|
567
|
+
whyOpen?: true; // With `why`: the explanation stands open as a box under the step from `sm` up; the toggle closes it.
|
|
568
|
+
whyTitle?: string; // Bold lead-in of the `why` paragraph.
|
|
569
|
+
[field: string]: unknown;
|
|
570
|
+
};
|
|
571
|
+
type RecordStepsSpec = {
|
|
572
|
+
field: string; // Holds `RecordStep[]`.
|
|
573
|
+
title?: string; // i18n key, default `kumiko.detail.steps.title`.
|
|
574
|
+
subtitleField?: string; // Record field with a plain-text subtitle.
|
|
575
|
+
emptyLabel?: string; // i18n key for an empty list, default `kumiko.detail.steps.empty`.
|
|
576
|
+
narrowLimit?: number; // Below `sm` only the first n steps show; the rest sits behind a "k more steps" toggle.
|
|
577
|
+
narrowMoreLabel?: string; // Plural base key for the toggle of the hidden rest: define `<key>.one` and `<key>.other` (the latter with `{count}`).
|
|
578
|
+
actions?: RecordGuidanceAction[];
|
|
579
|
+
};
|
|
580
|
+
type RecordSummarySpec = { // One emphasized sentence below the header; `field` holds a string.
|
|
581
|
+
field: string;
|
|
582
|
+
toneField?: string; // Row field holding a SelectOptionTone for the sentence's accent.
|
|
583
|
+
narrowField?: string; // Row field with a shorter sentence shown instead of `field` below `sm`.
|
|
584
|
+
};
|
|
448
585
|
type RelatedListEmptyStateSpec = ListEmptyStateSpec & { // The first `variants` entry whose `when` holds for the parent record replaces `title` and `description`; `action` stays.
|
|
449
586
|
variants?: RelatedListEmptyStateVariant[];
|
|
450
587
|
};
|
|
@@ -488,7 +625,7 @@ type RowActionDrawer = {
|
|
|
488
625
|
subtitle?: string; // Line under the drawer heading (i18n key or a bare `{name}` template), resolved like `title`.
|
|
489
626
|
rowClick?: boolean; // Clicking the row opens this drawer with that row's `params`.
|
|
490
627
|
};
|
|
491
|
-
type RowActionMode = "adaptive" | "inline"; // Row-action column layout.
|
|
628
|
+
type RowActionMode = "adaptive" | "inline" | "menu"; // Row-action column layout.
|
|
492
629
|
type RowActionNavigate = RowActionNavigateBase & ({ screen: string; entity?: never; } | { entity: string; screen?: never; }); // Exactly one of `screen` / `entity` — mutual exclusivity is type-enforced (boot validator still rejects both/neither for untyped schemas).
|
|
493
630
|
type RowFieldExtractor = // Declarative row-field extractor — JSON-safe (no function prop, survives GET /api/schema / buildAppSchema).
|
|
494
631
|
| {
|
|
@@ -568,4 +705,4 @@ type WorkspaceSchema = {
|
|
|
568
705
|
};
|
|
569
706
|
```
|
|
570
707
|
|
|
571
|
-
Also exported here, documented in `api/framework-engine.md`: `AccessRule`, `ActionFormScreenDefinition`, `ConfigEditScreenDefinition`, `DashboardCustomPanel`, `DashboardI18nText`, `EditFieldSpec`, `EditRelatedListSection`, `EditSectionSpec`, `EntityDefinition`, `EntityEditScreenDefinition`, `EntityListScreenDefinition`, `FieldCondition`, `FieldDefinition`, `ListColumnSpec`, `ListFacetSpec`, `ListTableOptions`, `MetricNavigate`, `NavDefinition`, `NavIconKey`, `ProjectionDetailScreenDefinition`, `ProjectionListScreenDefinition`, `RowAction`, `RowActionWriteHandler`, `ScreenDefinition`, `SecretMintScreenDefinition`, `TargetRef`, `ToolbarAction`, `TreeAction`, `WorkspaceDefinition`, `handlerFieldLabelKey`, `handlerTitleKey`, `isFieldsEditSection`, `isOpenToAllGranted`, `normalizeEditField`, `normalizeListColumn`, `parseRefTarget`, `sectionFieldSpecs`
|
|
708
|
+
Also exported here, documented in `api/framework-engine.md`: `AccessRule`, `ActionFormScreenDefinition`, `ConfigEditScreenDefinition`, `DashboardCustomPanel`, `DashboardI18nText`, `EditFieldSpec`, `EditRelatedListSection`, `EditSectionSpec`, `EntityDefinition`, `EntityEditScreenDefinition`, `EntityListScreenDefinition`, `FieldCondition`, `FieldDefinition`, `ListColumnSpec`, `ListFacetSpec`, `ListTableOptions`, `MetricNavigate`, `NavDefinition`, `NavIconKey`, `ProjectionDetailScreenDefinition`, `ProjectionListScreenDefinition`, `RowAction`, `RowActionWriteHandler`, `ScreenDefinition`, `SecretMintScreenDefinition`, `TargetRef`, `ToolbarAction`, `TreeAction`, `WorkspaceDefinition`, `handlerFieldLabelKey`, `handlerTitleKey`, `isFieldsEditSection`, `isOpenToAllGranted`, `isUnchangedValue`, `normalizeEditField`, `normalizeListColumn`, `parseRefTarget`, `sectionFieldSpecs`
|