@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
package/agents/api/types.md
CHANGED
|
@@ -485,6 +485,7 @@ type GenerateMigrationOutput = {
|
|
|
485
485
|
retiredDrops: RetiredFrameworkTable[];
|
|
486
486
|
rowLevelSecurityChanges: RowLevelSecurityChange[];
|
|
487
487
|
};
|
|
488
|
+
const SNAPSHOT_VERSION: 1;
|
|
488
489
|
type SchemaDiff = {
|
|
489
490
|
newTables: EntityTableMeta[];
|
|
490
491
|
droppedTables: string[];
|
|
@@ -699,6 +700,8 @@ type RenderDdlOptions = {
|
|
|
699
700
|
## packages/framework/src/db/render-rls-ddl.ts
|
|
700
701
|
|
|
701
702
|
```ts
|
|
703
|
+
const POLICY_COMMANDS: ["ALL", "SELECT", "INSERT", "UPDATE", "DELETE"];
|
|
704
|
+
const POLICY_KINDS: ["PERMISSIVE", "RESTRICTIVE"];
|
|
702
705
|
type RowLevelSecurityPolicy = {
|
|
703
706
|
name: string;
|
|
704
707
|
command: (typeof POLICY_COMMANDS)[number];
|
|
@@ -859,7 +862,6 @@ type ConfigKeyOptions<T extends ConfigKeyType> = {
|
|
|
859
862
|
pattern?: T extends "text" ? { regex: string; flags?: string; } : never;
|
|
860
863
|
computed?: ConfigComputedFn<T>;
|
|
861
864
|
validate?: ConfigValidateFn<T>;
|
|
862
|
-
allowPerRequest?: T extends "text" ? never : boolean;
|
|
863
865
|
required?: boolean;
|
|
864
866
|
env?: string;
|
|
865
867
|
inheritedToTenant?: boolean;
|
|
@@ -996,6 +998,7 @@ type UserId = string;
|
|
|
996
998
|
## packages/framework/src/engine/feature-changelog.ts
|
|
997
999
|
|
|
998
1000
|
```ts
|
|
1001
|
+
const CHANGELOG_TYPES: ["breaking", "improvement", "fix"];
|
|
999
1002
|
type ChangelogType = (typeof CHANGELOG_TYPES)[number];
|
|
1000
1003
|
type FeatureChangelog = {
|
|
1001
1004
|
feature: string;
|
|
@@ -1059,6 +1062,7 @@ type QnType = string;
|
|
|
1059
1062
|
## packages/framework/src/engine/role-assignment.ts
|
|
1060
1063
|
|
|
1061
1064
|
```ts
|
|
1065
|
+
const ASSIGNABLE_FROM_ROLE_LIST: ["User", "Member", "Editor", "Admin", "TenantAdmin", "SystemAdmin"];
|
|
1062
1066
|
type AssignableFromRole = (typeof ASSIGNABLE_FROM_ROLE_LIST)[number];
|
|
1063
1067
|
```
|
|
1064
1068
|
|
|
@@ -1083,6 +1087,10 @@ type StepListOutcome =
|
|
|
1083
1087
|
## packages/framework/src/engine/screen-helpers.ts
|
|
1084
1088
|
|
|
1085
1089
|
```ts
|
|
1090
|
+
type EmptyStateText = {
|
|
1091
|
+
title: string;
|
|
1092
|
+
description?: string | undefined;
|
|
1093
|
+
};
|
|
1086
1094
|
type FieldsOrGroupsSection = { // Structural reader contract for every section that can carry `fields` and/or `groups`: the `EditFieldsSection` union members and `EditWriteFormSection` all assign without narrowing.
|
|
1087
1095
|
fields?: EditFieldSpec[];
|
|
1088
1096
|
groups?: { title: string; fields: EditFieldSpec[]; }[];
|
|
@@ -1268,6 +1276,7 @@ type JobRunner = {
|
|
|
1268
1276
|
handleCatchUpEvent(jobName: string, eventName: string, payload: Record<string, unknown>, user: SessionUser, triggerEvent: JobTriggerEvent): Promise<void>;
|
|
1269
1277
|
attachDispatcher(ref: DispatchWriteRef): void;
|
|
1270
1278
|
countPendingJobs(): Promise<number>;
|
|
1279
|
+
isJobPending?(jobName: string, jobId: string): Promise<boolean>;
|
|
1271
1280
|
};
|
|
1272
1281
|
type JobRunnerOptions = {
|
|
1273
1282
|
registry: Registry;
|
|
@@ -1413,7 +1422,7 @@ type Dispatcher = {
|
|
|
1413
1422
|
|
|
1414
1423
|
```ts
|
|
1415
1424
|
type BatchTurnControl = {
|
|
1416
|
-
holdForRetry: (eventIds: string[], reason: string) => void;
|
|
1425
|
+
holdForRetry: (eventIds: string[], reason: string, options?: { stillBackingOff?: boolean; }) => void;
|
|
1417
1426
|
};
|
|
1418
1427
|
type DispatcherPassResult = {
|
|
1419
1428
|
processed: number;
|
|
@@ -1428,6 +1437,7 @@ type EventConsumer = {
|
|
|
1428
1437
|
featureName?: string;
|
|
1429
1438
|
delivery?: "shared" | "per-instance";
|
|
1430
1439
|
startFrom?: "beginning" | "now";
|
|
1440
|
+
irreversibleWithoutEntryHandler?: IrreversibleWithoutEntryHandler;
|
|
1431
1441
|
};
|
|
1432
1442
|
type EventConsumerBatchHandler = (events: StoredEvent[], ctx: AppContext, turn: BatchTurnControl) => Promise<void>;
|
|
1433
1443
|
type EventConsumerErrorPolicy = {
|
|
@@ -1515,6 +1525,7 @@ type RunEventStoreSeedOptions<TId extends string | number = string, TExisting ex
|
|
|
1515
1525
|
```ts
|
|
1516
1526
|
type CardColumnRoles<C extends CardRoleColumn> = {
|
|
1517
1527
|
image: C | undefined;
|
|
1528
|
+
lead: C | undefined; // The "to do" sentence shown above the title.
|
|
1518
1529
|
title: C | undefined;
|
|
1519
1530
|
status: C | undefined;
|
|
1520
1531
|
meta: C[];
|
|
@@ -1525,9 +1536,11 @@ type CardRoleColumn = {
|
|
|
1525
1536
|
type?: string;
|
|
1526
1537
|
renderer?: unknown;
|
|
1527
1538
|
hideOnNarrow?: boolean;
|
|
1539
|
+
narrowInline?: boolean;
|
|
1528
1540
|
fileDisplay?: {
|
|
1529
1541
|
kind: string;
|
|
1530
1542
|
};
|
|
1543
|
+
hint?: unknown; // A "to do" hint column: never the default card title.
|
|
1531
1544
|
};
|
|
1532
1545
|
```
|
|
1533
1546
|
|
|
@@ -1593,6 +1606,40 @@ type ContentEditorProps = {
|
|
|
1593
1606
|
};
|
|
1594
1607
|
```
|
|
1595
1608
|
|
|
1609
|
+
## packages/renderer/src/app/content-previews.tsx
|
|
1610
|
+
|
|
1611
|
+
```ts
|
|
1612
|
+
type ContentPreviewsMap = Partial<Record<PreviewTarget, PreviewRenderer>>;
|
|
1613
|
+
const PREVIEW_TARGETS: ["pdf", "mail", "web", "text"];
|
|
1614
|
+
type PreviewRenderer = ComponentType<PreviewRendererProps>;
|
|
1615
|
+
type PreviewRendererProps = {
|
|
1616
|
+
content: string;
|
|
1617
|
+
editFormat: ContentEditorFormat;
|
|
1618
|
+
variables: Readonly<Record<string, unknown>>;
|
|
1619
|
+
subject: PreviewSubject;
|
|
1620
|
+
onResult?: (result: unknown) => void; // The renderer hands the answer of its server call to a host that shows it elsewhere (the mail editor's side rail).
|
|
1621
|
+
};
|
|
1622
|
+
type PreviewSubject =
|
|
1623
|
+
| {
|
|
1624
|
+
kind: "template";
|
|
1625
|
+
templateKind: string;
|
|
1626
|
+
slug: string;
|
|
1627
|
+
locale: string;
|
|
1628
|
+
meta: unknown;
|
|
1629
|
+
variableSchema?: unknown; // Placeholder schema of the template; the server derives sample values from it.
|
|
1630
|
+
}
|
|
1631
|
+
| {
|
|
1632
|
+
kind: "layout";
|
|
1633
|
+
templateKind: string;
|
|
1634
|
+
html: string;
|
|
1635
|
+
}
|
|
1636
|
+
| {
|
|
1637
|
+
kind: "body";
|
|
1638
|
+
}
|
|
1639
|
+
;
|
|
1640
|
+
type PreviewTarget = (typeof PREVIEW_TARGETS)[number];
|
|
1641
|
+
```
|
|
1642
|
+
|
|
1596
1643
|
## packages/renderer/src/app/extension-sections.tsx
|
|
1597
1644
|
|
|
1598
1645
|
```ts
|
|
@@ -1634,6 +1681,27 @@ type ScreenTarget = {
|
|
|
1634
1681
|
};
|
|
1635
1682
|
```
|
|
1636
1683
|
|
|
1684
|
+
## packages/renderer/src/card-options.ts
|
|
1685
|
+
|
|
1686
|
+
```ts
|
|
1687
|
+
type CardOptions = { // Card-Options — Verhalten/Optik, ebenfalls additiv erweiterbar.
|
|
1688
|
+
padded?: boolean; // Body-Padding (px-6 py-6).
|
|
1689
|
+
radius?: "lg" | "xl"; // Eckenradius.
|
|
1690
|
+
footerBordered?: boolean; // Separates the footer with `border-t` and `bg-muted/30`.
|
|
1691
|
+
footerInset?: boolean; // Footer horizontal padding.
|
|
1692
|
+
fillHeight?: boolean; // Joins the ancestor fillHeight flex chain — a tabs-mode relatedList table sizing to the panel instead of the page — instead of normal document-flow height.
|
|
1693
|
+
framed?: boolean; // false drops border, background, shadow and radius but keeps padding and header slots — a panel inside a host surface such as a tab panel.
|
|
1694
|
+
screenBody?: boolean; // The card is the whole screen body (secretMint reveal and done phase): no frame, the shared screen insets and width of form screens, children stacked with a gap.
|
|
1695
|
+
headerLayout?: "stacked" | "inline"; // "inline": title and subtitle on one baseline row at 16px inset, compact padding (the board's side panel).
|
|
1696
|
+
};
|
|
1697
|
+
```
|
|
1698
|
+
|
|
1699
|
+
## packages/renderer/src/components/form-pending-uploads.tsx
|
|
1700
|
+
|
|
1701
|
+
```ts
|
|
1702
|
+
type TrackFormUpload = <T>(upload: () => Promise<T>) => Promise<T>;
|
|
1703
|
+
```
|
|
1704
|
+
|
|
1637
1705
|
## packages/renderer/src/components/list-empty-state.tsx
|
|
1638
1706
|
|
|
1639
1707
|
```ts
|
|
@@ -1642,6 +1710,15 @@ type ListEmptyStateContent = {
|
|
|
1642
1710
|
description?: string;
|
|
1643
1711
|
action?: RenderEditAction;
|
|
1644
1712
|
};
|
|
1713
|
+
type NamedFilterEmptyContent = {
|
|
1714
|
+
title: string;
|
|
1715
|
+
description?: string;
|
|
1716
|
+
describedByQuery?: {
|
|
1717
|
+
query: string;
|
|
1718
|
+
describe: (params: Readonly<Record<string, unknown>>) => string;
|
|
1719
|
+
}; // The description needs params from a query; it renders only once the query returned an object.
|
|
1720
|
+
onReset: () => void;
|
|
1721
|
+
};
|
|
1645
1722
|
```
|
|
1646
1723
|
|
|
1647
1724
|
## packages/renderer/src/components/render-edit-types.ts
|
|
@@ -1652,6 +1729,7 @@ type RenderEditAction = {
|
|
|
1652
1729
|
label: string;
|
|
1653
1730
|
onPress: () => void | Promise<void>;
|
|
1654
1731
|
style?: "primary" | "secondary" | "danger";
|
|
1732
|
+
display?: RowActionDisplay; // `"link"` draws the action as a text link; `style: "danger"` keeps its colour.
|
|
1655
1733
|
confirm?: string;
|
|
1656
1734
|
confirmLabel?: string;
|
|
1657
1735
|
confirmRequired?: boolean; // Overrides the default "danger implies a confirm dialog" rule.
|
|
@@ -1670,7 +1748,7 @@ type ToolbarActionButton = {
|
|
|
1670
1748
|
confirmLabel?: string;
|
|
1671
1749
|
confirmRequired?: boolean; // Overrides the default "danger implies a confirm dialog" rule.
|
|
1672
1750
|
onTrigger: () => Promise<void> | void;
|
|
1673
|
-
icon?: IconKey; //
|
|
1751
|
+
icon?: IconKey; // The action's declared icon, else the id-derived default (ACTION_ICON_BY_ID).
|
|
1674
1752
|
};
|
|
1675
1753
|
```
|
|
1676
1754
|
|
|
@@ -1767,8 +1845,10 @@ type DataTableFacet = {
|
|
|
1767
1845
|
label: string; // Translated Button-Label ("Status", "Active").
|
|
1768
1846
|
options: { value: string; label: string; }[]; // Selectable values with display labels.
|
|
1769
1847
|
chips?: DataTableFacetChip[]; // Present: render the facet as a row of single-choice toggle chips instead of a dropdown.
|
|
1848
|
+
display?: "select"; // Chips only: "select" renders the chips as one single-choice dropdown instead of a row of toggles.
|
|
1770
1849
|
showCounts?: boolean; // Chips only: show each chip's `count` next to its label.
|
|
1771
1850
|
hideEmpty?: boolean; // Chips only: hide chips whose `count` is 0 (unless pressed).
|
|
1851
|
+
narrowPlacement?: "behind-filter"; // Below `sm` the facet opens behind the filter icon next to the search field instead of standing as a pill.
|
|
1772
1852
|
onSearchChange?: (query: string) => void; // Present: the options come from a server-side search (reference facets), so the dropdown shows a search field and reports the typed term instead of filtering `options` itself.
|
|
1773
1853
|
searching?: boolean; // The search is loading; the option list may still show the previous term's rows.
|
|
1774
1854
|
};
|
|
@@ -1776,6 +1856,7 @@ type DataTableFacetChip = {
|
|
|
1776
1856
|
id: string;
|
|
1777
1857
|
label: string; // Translated chip label.
|
|
1778
1858
|
values: string[]; // Selection a click sets; `[]` clears the facet.
|
|
1859
|
+
separatorAfter?: boolean; // Select display: a divider line follows this chip.
|
|
1779
1860
|
count?: number; // Matching row count, undefined while unknown.
|
|
1780
1861
|
};
|
|
1781
1862
|
```
|
|
@@ -1802,12 +1883,24 @@ type DataTableResetAll = {
|
|
|
1802
1883
|
active: boolean; // True while something deviates from the screen default.
|
|
1803
1884
|
onReset: () => void;
|
|
1804
1885
|
};
|
|
1886
|
+
type DataTableSummaryItem = {
|
|
1887
|
+
label?: string; // Absent: the cell shows the value alone, for values that carry their own meaning ("7 need action").
|
|
1888
|
+
value: string | number;
|
|
1889
|
+
tone?: SelectOptionTone;
|
|
1890
|
+
column?: string; // Column field the value stands under when the table draws the row as cells; absent goes to the first column.
|
|
1891
|
+
};
|
|
1892
|
+
type DataTableSummaryRow = { // One line of "label value" pairs (the label is optional) under the rows, answered by the screen's summaryRow query.
|
|
1893
|
+
items: DataTableSummaryItem[];
|
|
1894
|
+
};
|
|
1805
1895
|
type DataTableTableBlock = { // The DataTable props a screen's `table` block feeds.
|
|
1806
1896
|
view?: DataTableViewOptions; // View menu (column picker, density); absent = no menu.
|
|
1807
1897
|
resetAll?: DataTableResetAll; // Replaces the facet reset with one that also covers sort, search and page size.
|
|
1808
1898
|
exportList?: DataTableExport; // Present: the toolbar has an export button (web only).
|
|
1809
1899
|
compactHeader?: boolean; // Smaller (12px) semibold header row.
|
|
1900
|
+
frame?: ListTableFrame; // "card": table, summary row and pager in one bordered card from sm; bordered cards with a gap below sm.
|
|
1901
|
+
narrowFacets?: ListNarrowFacets; // "pills": below sm the select facets render as rounded pill triggers with a stronger border.
|
|
1810
1902
|
serverGroups?: DataTableServerGroups; // Present: the rows are grouped on the server; replaces pager and infinite scroll.
|
|
1903
|
+
summaryRow?: DataTableSummaryRow; // Present: a footer line above the totals row with the summary query's items.
|
|
1811
1904
|
totals?: DataTableTotals; // Present: a footer row with the server-computed totals of the filtered list.
|
|
1812
1905
|
notice?: DataTableListNotice; // Present: the toolbar says the answer is incomplete and asks to narrow the list.
|
|
1813
1906
|
rangeFacets?: DataTableRangeFacet[];
|
|
@@ -2195,6 +2288,7 @@ type EmbeddedListCellViewModel = {
|
|
|
2195
2288
|
refOptionsQuery?: string;
|
|
2196
2289
|
scale?: number; // Only for `type: "decimal"`.
|
|
2197
2290
|
};
|
|
2291
|
+
type ListColumnCellDisplay = "badge" | "button";
|
|
2198
2292
|
type ListColumnFileDisplay = // How a list cell shows a FileRef value (id or id array).
|
|
2199
2293
|
| {
|
|
2200
2294
|
kind: "image";
|
|
@@ -2202,14 +2296,28 @@ type ListColumnFileDisplay = // How a list cell shows a FileRef value (id or id
|
|
|
2202
2296
|
}
|
|
2203
2297
|
| {
|
|
2204
2298
|
kind: "file";
|
|
2299
|
+
viewInDrawer?: true;
|
|
2205
2300
|
}
|
|
2206
2301
|
;
|
|
2302
|
+
type ListColumnHintViewModel = {
|
|
2303
|
+
detailField?: string;
|
|
2304
|
+
narrowDetailField?: string; // `ListColumnHint.narrowDetailField`: replaces `detailField` in the phone card.
|
|
2305
|
+
narrowField?: string; // `ListColumnHint.narrowField`: replaces the sentence value in the phone card.
|
|
2306
|
+
toneField?: string;
|
|
2307
|
+
reasonField?: string;
|
|
2308
|
+
reasonOpenField?: string;
|
|
2309
|
+
reasonTitleField?: string;
|
|
2310
|
+
plainSentence?: boolean; // `ListColumnHint.plainSentence`: the sentence keeps the normal text color.
|
|
2311
|
+
emptyLabel: string;
|
|
2312
|
+
reasonLabel: string; // Label of the reason toggle, already translated.
|
|
2313
|
+
};
|
|
2207
2314
|
type ListColumnViewModel = {
|
|
2208
2315
|
field: string;
|
|
2209
2316
|
label: string;
|
|
2210
2317
|
type: string;
|
|
2211
2318
|
renderer?: FieldRenderer | RuntimeRenderer;
|
|
2212
2319
|
linkFor?: RuntimeCellLink;
|
|
2320
|
+
rowActionLink?: boolean; // Per-row action link column: a text link right-aligned without header text from sm, a small outline button on cards.
|
|
2213
2321
|
linkItemsFor?: RuntimeCellLinkItems;
|
|
2214
2322
|
sortable: boolean;
|
|
2215
2323
|
optionLabels?: Readonly<Record<string, string>>; // Only for `type: "select"` or `type: "multiSelect"` — translated option labels keyed by raw value.
|
|
@@ -2219,8 +2327,17 @@ type ListColumnViewModel = {
|
|
|
2219
2327
|
refLabelField?: string; // Only for `type: "reference"` — which field of the referenced entity appears as the display value in the cell (default "id").
|
|
2220
2328
|
highlighted?: boolean; // Set by the caller at runtime (not schema-derived) to emphasize one column — e.g. the currently selected base-year column in a multi-year statement grid.
|
|
2221
2329
|
hideOnNarrow?: boolean; // Mirrors `ListColumnSpec.hideOnNarrow`: card layout skips the column.
|
|
2330
|
+
showOnNarrowOnly?: boolean; // Mirrors `ListColumnSpec.showOnNarrowOnly`: the table layout skips the column.
|
|
2331
|
+
narrowInline?: boolean; // Mirrors `ListColumnSpec.narrowInline`: the card draws consecutive such columns on one line.
|
|
2222
2332
|
grouping?: boolean; // Only for `type: "number"` — mirrors `NumberFieldDef.grouping` (default `true`).
|
|
2223
2333
|
fileDisplay?: ListColumnFileDisplay; // Set for file/image columns: from the entity field type, or from a `{ format: "image" | "file" }` renderer.
|
|
2334
|
+
hint?: ListColumnHintViewModel; // "To do" cell (`ListColumnSpec.hint`), `emptyLabel` already translated.
|
|
2335
|
+
width?: number; // Start width and floor in px of a hint column; unlike other columns they apply without `table.resizing`.
|
|
2336
|
+
minWidth?: number;
|
|
2337
|
+
display?: ListColumnCellDisplay; // `ListColumnSpec.display` for list tables: a status pill or a link drawn as a button.
|
|
2338
|
+
badgeToneField?: string; // Row field naming the pill tone; only with `display: "badge"`.
|
|
2339
|
+
badgeDot?: false; // `false`: the pill has no leading dot.
|
|
2340
|
+
emptyPlaceholder?: false; // `false`: an empty cell stays blank instead of showing "—".
|
|
2224
2341
|
};
|
|
2225
2342
|
type ListRowViewModel = {
|
|
2226
2343
|
id: string;
|
|
@@ -2256,6 +2373,36 @@ type MetricProps = { // Compact label/value tile (record-detail metrics band).
|
|
|
2256
2373
|
tile?: boolean; // Draw as a KPI tile (the dashboard StatCard) instead of a band entry.
|
|
2257
2374
|
tone?: DashboardStatTone;
|
|
2258
2375
|
icon?: NavIconKey;
|
|
2376
|
+
sub?: string; // Small muted line under the value (see `MetricSpec.subField`).
|
|
2377
|
+
narrowSub?: string; // Replaces `sub` below `sm` (see `MetricSpec.subFieldNarrow`).
|
|
2378
|
+
};
|
|
2379
|
+
```
|
|
2380
|
+
|
|
2381
|
+
## packages/renderer/src/primitives-record-guidance.ts
|
|
2382
|
+
|
|
2383
|
+
```ts
|
|
2384
|
+
type RecordBreadcrumbProps = { // Path above a record header; an item with a `link` is a link, the last item without one names the current record.
|
|
2385
|
+
items: { label: string; link?: CellLink; }[];
|
|
2386
|
+
ariaLabel: string;
|
|
2387
|
+
testId?: string;
|
|
2388
|
+
};
|
|
2389
|
+
type RecordStepsProps = { // "Next steps" panel; an item's `reason` sits behind a toggle labelled `reasonLabel`.
|
|
2390
|
+
title: string;
|
|
2391
|
+
subtitle?: string;
|
|
2392
|
+
emptyLabel: string; // Shown instead of the list when there are no items.
|
|
2393
|
+
reasonLabel: string;
|
|
2394
|
+
narrowLimit?: number; // Below the sm breakpoint only this many steps show; the rest sits behind a toggle.
|
|
2395
|
+
moreLabel?: (hiddenCount: number) => string; // Toggle label for the hidden steps; receives their count.
|
|
2396
|
+
lessLabel?: string;
|
|
2397
|
+
items: { id: string; title: string; narrowTitle?: string; detail?: string; narrowDetail?: string; tone?: SelectOptionTone; reason?: string; reasonOpen?: true; reasonTitle?: string; actions?: ReactNode; moreActions?: ReactNode; }[];
|
|
2398
|
+
count?: number; // Total number of steps, shown small beside the heading even when `narrowLimit` shortens the list.
|
|
2399
|
+
testId?: string;
|
|
2400
|
+
};
|
|
2401
|
+
type RecordSummaryProps = { // One emphasized sentence below a record header; `tone` sets the accent color.
|
|
2402
|
+
text: string;
|
|
2403
|
+
narrowText?: string; // Shown instead of `text` below the sm breakpoint.
|
|
2404
|
+
tone?: SelectOptionTone;
|
|
2405
|
+
testId?: string;
|
|
2259
2406
|
};
|
|
2260
2407
|
```
|
|
2261
2408
|
|
|
@@ -2295,15 +2442,6 @@ type ButtonBaseProps = {
|
|
|
2295
2442
|
iconEnd?: NavIconKey; // Icon after the label (e.g. "Continue →").
|
|
2296
2443
|
dataAttributes?: DataAttributes;
|
|
2297
2444
|
};
|
|
2298
|
-
type CardOptions = { // Card-Options — Verhalten/Optik, ebenfalls additiv erweiterbar.
|
|
2299
|
-
padded?: boolean; // Body-Padding (px-6 py-6).
|
|
2300
|
-
radius?: "lg" | "xl"; // Eckenradius.
|
|
2301
|
-
footerBordered?: boolean; // Separates the footer with `border-t` and `bg-muted/30`.
|
|
2302
|
-
footerInset?: boolean; // Footer horizontal padding.
|
|
2303
|
-
fillHeight?: boolean; // Joins the ancestor fillHeight flex chain — a tabs-mode relatedList table sizing to the panel instead of the page — instead of normal document-flow height.
|
|
2304
|
-
framed?: boolean; // false drops border, background, shadow and radius but keeps padding and header slots — a panel inside a host surface such as a tab panel.
|
|
2305
|
-
screenBody?: boolean; // The card is the whole screen body (secretMint reveal and done phase): no frame, the shared screen insets and width of form screens, children stacked with a gap.
|
|
2306
|
-
};
|
|
2307
2445
|
type CardSlots = { // Card slots are named content regions, all optional.
|
|
2308
2446
|
header?: ReactNode;
|
|
2309
2447
|
title?: ReactNode;
|
|
@@ -2346,7 +2484,7 @@ type DataTableRowAction = {
|
|
|
2346
2484
|
icon?: IconKey; // Resolved icon (author `RowAction.icon` or the id-derived default) — drives both the icon-left-of-text render and the icon-only collapse rule (see `shouldRenderActionsIconOnly`).
|
|
2347
2485
|
display?: RowActionDisplay; // Author-chosen inline form (`RowAction.display`).
|
|
2348
2486
|
};
|
|
2349
|
-
type DataTableRowActionMode = "adaptive" | "inline";
|
|
2487
|
+
type DataTableRowActionMode = "adaptive" | "inline" | "menu";
|
|
2350
2488
|
type DataTableSort = {
|
|
2351
2489
|
field: string;
|
|
2352
2490
|
dir: DataTableSortDir;
|
|
@@ -2383,6 +2521,7 @@ type FileValueListProps = { // Read-only list of stored files (FileRef ids): nam
|
|
|
2383
2521
|
type FillContainerProps = { // Chromeless flex-fill layout host — no title, no card frame, no padding, just a container that sizes to its content and, once the ancestor chain is height-constrained, shrinks so one scrolling child can scroll internally instead of the page growing.
|
|
2384
2522
|
children: ReactNode;
|
|
2385
2523
|
testId?: string;
|
|
2524
|
+
className?: string; // Layout extras, merged via cn().
|
|
2386
2525
|
grow?: boolean; // Claims the remaining height of the flex chain (`flex-1`) instead of sizing to its content, so a footer inside the child sits at the bottom edge even with few rows.
|
|
2387
2526
|
};
|
|
2388
2527
|
type FormSectionNavItem = { // One entry of a form's "on this page" navigation: `id` matches the `SectionProps.id` of the section it scrolls to.
|
|
@@ -2440,9 +2579,10 @@ type PageHeaderProps = { // Page title area rendered by the app shell's header i
|
|
|
2440
2579
|
recordTitle?: string; // Name of the loaded record; shown as an extra breadcrumb before the last one.
|
|
2441
2580
|
status?: ReactNode;
|
|
2442
2581
|
actions?: ReactNode;
|
|
2582
|
+
bodyTitle?: boolean; // Screen renders its own h1: the shell header shows only the parent crumb, as text.
|
|
2443
2583
|
overflowItems?: ActionMenuItemSpec[]; // Land in the shell header's overflow menu at phone width.
|
|
2444
|
-
hideBreadcrumb?: boolean; // Hide the shell header's breadcrumb while mounted
|
|
2445
|
-
breadcrumbScreenId?: string; // Label the breadcrumb with this screen (id
|
|
2584
|
+
hideBreadcrumb?: boolean; // Hide the shell header's breadcrumb while mounted (a locked screen's fallback).
|
|
2585
|
+
breadcrumbScreenId?: string; // Label the breadcrumb with this screen (route id) instead of the routed one; wins over `hideBreadcrumb`.
|
|
2446
2586
|
};
|
|
2447
2587
|
type PickedFile = { // Platform-neutral view of a picked file; the DOM `File` satisfies it.
|
|
2448
2588
|
name: string;
|
|
@@ -2510,10 +2650,10 @@ type StepBarProps = { // Wizard step overview — numbered chips, one per step l
|
|
|
2510
2650
|
doneSteps?: boolean[]; // Explicit done state per step index.
|
|
2511
2651
|
selectableSteps?: "done" | "all"; // "done" (default): only done steps are jump targets.
|
|
2512
2652
|
narrowLayout?: "label" | "steps"; // "label" (default) swaps the step row for `compactLabel` on narrow viewports; "steps" keeps the row there too — for short wizards whose labels fit a phone and whose done steps must stay tappable.
|
|
2513
|
-
orientation?: "horizontal" | "vertical"; // "vertical" renders a step rail (from `lg`, with `compactLabel` as the single line below it)
|
|
2653
|
+
orientation?: "horizontal" | "vertical" | "stacked"; // "vertical" renders a step rail (from `lg`, with `compactLabel` as the single line below it); "stacked": plain stage list at every width.
|
|
2514
2654
|
heading?: string; // Vertical only: rail heading ("Step 4 of 6") and optional description.
|
|
2515
2655
|
description?: string;
|
|
2516
|
-
subtitles?: (string | undefined)[]; // Vertical only: line under each step label, same order as `steps`.
|
|
2656
|
+
subtitles?: (string | undefined)[]; // Vertical and stacked only: line under each step label, same order as `steps`.
|
|
2517
2657
|
upNext?: {
|
|
2518
2658
|
heading: string;
|
|
2519
2659
|
title: string;
|
|
@@ -2554,7 +2694,6 @@ type WizardStepGroupProps = { // Wraps a single wizard step so it stays mounted
|
|
|
2554
2694
|
|
|
2555
2695
|
```ts
|
|
2556
2696
|
type StatusBadgeOptionTone = StatusTone | "accent"; // Tones a select option can request: the status tones plus the brand `accent`.
|
|
2557
|
-
type StatusTone = "ok" | "warn" | "bad" | "critical" | "muted";
|
|
2558
2697
|
```
|
|
2559
2698
|
|
|
2560
2699
|
## packages/renderer/src/web/app/client-plugin.tsx
|
|
@@ -2582,6 +2721,12 @@ type BoundaryErrorHandler = (error: Error, info: ErrorInfo, context: BoundaryErr
|
|
|
2582
2721
|
type ResolverComponent = ComponentType<{ target: TargetRef; onClose: () => void; }>;
|
|
2583
2722
|
```
|
|
2584
2723
|
|
|
2724
|
+
## packages/renderer/src/web/editor/editor-rail.tsx
|
|
2725
|
+
|
|
2726
|
+
```ts
|
|
2727
|
+
const TRAILING_TONE: { ok: "text-status-ok"; bad: "text-status-bad"; muted: "text-muted-foreground"; };
|
|
2728
|
+
```
|
|
2729
|
+
|
|
2585
2730
|
## packages/renderer/src/web/layout/default-app-shell.tsx
|
|
2586
2731
|
|
|
2587
2732
|
```ts
|
|
@@ -2591,6 +2736,12 @@ type DefaultAppShellUser = {
|
|
|
2591
2736
|
};
|
|
2592
2737
|
```
|
|
2593
2738
|
|
|
2739
|
+
## packages/renderer/src/web/layout/shell-style.tsx
|
|
2740
|
+
|
|
2741
|
+
```ts
|
|
2742
|
+
type ShellNavStyle = "default" | "plain";
|
|
2743
|
+
```
|
|
2744
|
+
|
|
2594
2745
|
## packages/renderer/src/web/layout/sidebar-panel.tsx
|
|
2595
2746
|
|
|
2596
2747
|
```ts
|
|
@@ -2633,6 +2784,7 @@ type PageSectionProps = {
|
|
|
2633
2784
|
testId?: string;
|
|
2634
2785
|
maxWidth?: ScreenWidth;
|
|
2635
2786
|
};
|
|
2787
|
+
const STACK_GAP: { sm: "gap-2"; md: "gap-4"; lg: "gap-6"; };
|
|
2636
2788
|
type ScreenWidth = FormWidth;
|
|
2637
2789
|
type StackGap = keyof typeof STACK_GAP;
|
|
2638
2790
|
type StackProps = {
|
|
@@ -2641,6 +2793,7 @@ type StackProps = {
|
|
|
2641
2793
|
children?: ReactNode;
|
|
2642
2794
|
testId?: string;
|
|
2643
2795
|
};
|
|
2796
|
+
const screenFormColumnWidthClassName: Record<ScreenWidth, string>;
|
|
2644
2797
|
```
|
|
2645
2798
|
|
|
2646
2799
|
## packages/renderer/src/web/primitives/toast.tsx
|
|
@@ -2659,6 +2812,12 @@ type LiveEventTimers = {
|
|
|
2659
2812
|
};
|
|
2660
2813
|
```
|
|
2661
2814
|
|
|
2815
|
+
## packages/renderer/src/web/ui/sidebar.tsx
|
|
2816
|
+
|
|
2817
|
+
```ts
|
|
2818
|
+
const sidebarMenuButtonVariants;
|
|
2819
|
+
```
|
|
2820
|
+
|
|
2662
2821
|
## packages/renderer/src/web/widgets/ai-text-field.tsx
|
|
2663
2822
|
|
|
2664
2823
|
```ts
|
|
@@ -2808,6 +2967,9 @@ type ClockStep = {
|
|
|
2808
2967
|
## packages/testing/src/helpers/seed.ts
|
|
2809
2968
|
|
|
2810
2969
|
```ts
|
|
2970
|
+
type SeedOptions = {
|
|
2971
|
+
projectionOnly?: string;
|
|
2972
|
+
};
|
|
2811
2973
|
type SeedTable = EntityTable | EntityTableMeta;
|
|
2812
2974
|
```
|
|
2813
2975
|
|
|
@@ -3042,6 +3204,8 @@ type ExtensionSelectorDef = {
|
|
|
3042
3204
|
panels?: ExtensionSelectorPanel[];
|
|
3043
3205
|
};
|
|
3044
3206
|
type ExtensionSelectorPanel = DashboardCustomPanel | Omit<DashboardScreenPanel, "label">;
|
|
3207
|
+
const IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES: ["rebuildable-derived-data", "high-risk-or-cron-pipeline", "per-dispatch-record-key"];
|
|
3208
|
+
type IrreversibleWithoutEntryHandler = (typeof IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES)[number];
|
|
3045
3209
|
type JobBackoff =
|
|
3046
3210
|
| JobBackoffStrategy
|
|
3047
3211
|
| {
|
|
@@ -3128,7 +3292,6 @@ type PgListenSubscription = {
|
|
|
3128
3292
|
type RawDbClient = {
|
|
3129
3293
|
unsafe: (sql: string, params?: unknown[]) => PromiseLike<unknown[]>;
|
|
3130
3294
|
begin: <T>(fn: (tx: DbTx) => Promise<T>) => Promise<T>;
|
|
3131
|
-
end?: (options?: { timeout?: number; }) => Promise<void>;
|
|
3132
3295
|
};
|
|
3133
3296
|
```
|
|
3134
3297
|
|
|
@@ -3282,6 +3445,7 @@ type UnmanagedTableInput = {
|
|
|
3282
3445
|
indexes?: IndexMeta[];
|
|
3283
3446
|
compositePrimaryKey?: CompositePrimaryKeyMeta;
|
|
3284
3447
|
tenancy?: EntityTenancy;
|
|
3448
|
+
systemRowsReadable?: true;
|
|
3285
3449
|
};
|
|
3286
3450
|
```
|
|
3287
3451
|
|
|
@@ -3343,6 +3507,7 @@ type ParentVisibilityOption = {
|
|
|
3343
3507
|
readModelEntities?: ReadonlyMap<string, { entity: EntityDefinition; table: SchemaTable; }>;
|
|
3344
3508
|
canReadEntity?: (entityName: string) => boolean;
|
|
3345
3509
|
resolveTable?: (entityName: string) => SchemaTable;
|
|
3510
|
+
globalHostIds?: ReadonlyMap<string, string[]>;
|
|
3346
3511
|
};
|
|
3347
3512
|
type PreSaveRunner = (changes: Record<string, unknown>, previous: Readonly<Record<string, unknown>>, isNew: boolean) => Promise<Record<string, unknown>>;
|
|
3348
3513
|
type StreamTenantOption = {
|
|
@@ -3825,6 +3990,7 @@ type ResolvedPiiStance =
|
|
|
3825
3990
|
subjectRef: true;
|
|
3826
3991
|
}
|
|
3827
3992
|
;
|
|
3993
|
+
const SELECT_OPTION_TONES: ["ok", "warn", "bad", "critical", "accent", "neutral"];
|
|
3828
3994
|
type SelectConditionalOptions<TOption extends string = string> = { // Options of a select field that are only available while `when` holds for the row values.
|
|
3829
3995
|
options: TOption[];
|
|
3830
3996
|
when: Exclude<FieldCondition, boolean>;
|
|
@@ -3976,6 +4142,7 @@ type ContextServices = { // Infrastructure the app wired at boot, as the handler
|
|
|
3976
4142
|
_notifyFactory?: NotifyFactory;
|
|
3977
4143
|
_notifyInTransactionFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
|
|
3978
4144
|
_notifyAfterCommitFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
|
|
4145
|
+
_logOwnDeliveryAttempt?: DeliveryAttemptLogFn;
|
|
3979
4146
|
_escapeHatchAuditSink?: EscapeHatchAuditSink;
|
|
3980
4147
|
extensions: Readonly<Record<string, unknown>>;
|
|
3981
4148
|
};
|
|
@@ -4060,6 +4227,7 @@ type DispatchWriteRef = {
|
|
|
4060
4227
|
queryAs: (user: SessionUser, qn: string, payload: unknown, inheritedOrigin?: WriteOrigin) => Promise<unknown>;
|
|
4061
4228
|
createMemberReader: (tenantId: TenantId) => MemberReader;
|
|
4062
4229
|
};
|
|
4230
|
+
const ESCAPE_HATCH_GRANTS: ["systemIdentity", "globalWrites", "unsafeRaw", "crossTenantReads"];
|
|
4063
4231
|
type EntityRef = {
|
|
4064
4232
|
name: string;
|
|
4065
4233
|
table: string;
|
|
@@ -4113,6 +4281,7 @@ type JobRunnerRef = {
|
|
|
4113
4281
|
handleEvent(eventName: string, payload: Record<string, unknown>, user?: SessionUser, triggerEvent?: JobTriggerEvent): Promise<void>;
|
|
4114
4282
|
handleCatchUpEvent?(jobName: string, eventName: string, payload: Record<string, unknown>, user: SessionUser, triggerEvent: JobTriggerEvent): Promise<void>;
|
|
4115
4283
|
dispatch?(jobName: string, payload: Record<string, unknown>, meta?: { priority?: number; jobId?: string; }): Promise<unknown>;
|
|
4284
|
+
isJobPending?(jobName: string, jobId: string): Promise<boolean>;
|
|
4116
4285
|
};
|
|
4117
4286
|
type JobTriggerEvent = {
|
|
4118
4287
|
id: string;
|
|
@@ -4149,6 +4318,7 @@ type PreparedOrSkipped<TPrepared, TWhenNested> = [ TWhenNested ] extends [ Befor
|
|
|
4149
4318
|
type PreparedWriteEvent<TPayload = unknown, TPrepared = unknown> = WriteEvent<TPayload> & ([ TPrepared ] extends [ undefined ] ? { prepared?: undefined; } : { prepared: TPrepared; }); // What a handler sees when its `beforeTransaction` phase ran: the phase's `data` as `prepared`; absent for handlers without the phase.
|
|
4150
4319
|
type QualifiedEventName<TFeature extends string, TInner extends string> = `${CamelToKebab<TFeature>}:event:${CamelToKebab<TInner>}`; // Builds the qualified event-name from feature + inner-name in the same shape the runtime emits via `qn(toKebab(feature), "event", toKebab(inner))`.
|
|
4151
4320
|
type QueryHandlerFn<TPayload = unknown, TResult = unknown> = (query: QueryEvent<TPayload>, context: HandlerContext) => Promise<TResult>;
|
|
4321
|
+
const RATE_LIMIT_PERS: ["user", "tenant", "ip", "user+handler", "tenant+handler", "ip+handler"];
|
|
4152
4322
|
type RateLimitDeclaration = RateLimitOption | RateLimitOptions | RateLimitDisabled;
|
|
4153
4323
|
type RateLimitDisabled = {
|
|
4154
4324
|
disabled: true;
|
|
@@ -4196,6 +4366,8 @@ type SharedContextFields = {
|
|
|
4196
4366
|
_notifyFactory?: NotifyFactory;
|
|
4197
4367
|
_notifyInTransactionFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
|
|
4198
4368
|
_notifyAfterCommitFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
|
|
4369
|
+
_deliveryAttemptLogFactory?: DeliveryAttemptLogFactory;
|
|
4370
|
+
_logOwnDeliveryAttempt?: DeliveryAttemptLogFn;
|
|
4199
4371
|
_escapeHatchAuditSink?: EscapeHatchAuditSink;
|
|
4200
4372
|
secrets?: SecretsContext;
|
|
4201
4373
|
masterKeyProvider?: MasterKeyProvider;
|
|
@@ -4346,6 +4518,7 @@ type SubjectId =
|
|
|
4346
4518
|
## packages/types/src/list-aggregate-types.ts
|
|
4347
4519
|
|
|
4348
4520
|
```ts
|
|
4521
|
+
const LIST_AGGREGATE_MEASURE_KINDS: ["sum", "avg", "count", "min", "max"];
|
|
4349
4522
|
type ListAggregateCurrencyAmount = {
|
|
4350
4523
|
currency: string;
|
|
4351
4524
|
value: number;
|
|
@@ -4386,7 +4559,7 @@ type Logger = {
|
|
|
4386
4559
|
```ts
|
|
4387
4560
|
type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> = {
|
|
4388
4561
|
appendEvent: AppendEventFn<TMap>;
|
|
4389
|
-
unsafeAppendEvent: UnsafeAppendEventFn;
|
|
4562
|
+
unsafeAppendEvent: (args: Parameters<UnsafeAppendEventFn>[0] & { expectedVersion?: number; }) => Promise<void>;
|
|
4390
4563
|
loadAggregate: (aggregateId: string, options?: { asOf?: Temporal.Instant; }) => Promise<StoredEvent[]>;
|
|
4391
4564
|
registry: Registry;
|
|
4392
4565
|
files?: FileContext;
|
|
@@ -4401,6 +4574,14 @@ type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> = {
|
|
|
4401
4574
|
## packages/types/src/named-list-filters.ts
|
|
4402
4575
|
|
|
4403
4576
|
```ts
|
|
4577
|
+
type ListSortDir = "asc" | "desc";
|
|
4578
|
+
type NamedFilterFacetOptions = { // How the named filters appear in the toolbar: toggle chips (default) or one single-choice select.
|
|
4579
|
+
display?: "chips" | "select";
|
|
4580
|
+
showCounts?: boolean; // Ask the list query for each filter's hit count and show it next to the label.
|
|
4581
|
+
hideEmpty?: boolean; // Select entries with zero hits are left out (the active one and "all" stay).
|
|
4582
|
+
narrowPlacement?: "behind-filter"; // "behind-filter": the select opens behind the filter icon next to the search field instead of standing as a pill.
|
|
4583
|
+
label?: string; // i18n key for the select's label, e.g. "To do".
|
|
4584
|
+
};
|
|
4404
4585
|
type NamedListFilterCondition = {
|
|
4405
4586
|
field: string;
|
|
4406
4587
|
op: NamedListFilterOp;
|
|
@@ -4414,6 +4595,14 @@ type NamedListFilterOp = "eq" | "ne" | "lt" | "gt" | "lte" | "gte" | "in";
|
|
|
4414
4595
|
type NamedListFilterRef = { // Screen-side reference to an entity-defined named filter; `label` is an i18n key.
|
|
4415
4596
|
id: string;
|
|
4416
4597
|
label: string;
|
|
4598
|
+
sort?: ListSortSpec; // Order while this filter is active and the URL carries no sort of its own; wins over `defaultSort`.
|
|
4599
|
+
separatorAfter?: boolean; // Select display: draws a divider line below this entry in the dropdown.
|
|
4600
|
+
emptyState?: {
|
|
4601
|
+
title: string;
|
|
4602
|
+
description?: string;
|
|
4603
|
+
paramsQuery?: string;
|
|
4604
|
+
}; // Shown instead of the generic "no matches" text when this filter yields an empty list and no search term is set; `title` and `description` are i18n keys.
|
|
4605
|
+
access?: AccessRule; // Set by the framework from the entity filter's access rule; the client offers the chip only where `isUiAccessGranted` allows it.
|
|
4417
4606
|
};
|
|
4418
4607
|
type NamedListFilterScope = {
|
|
4419
4608
|
ctx: HandlerContext;
|
|
@@ -4422,6 +4611,12 @@ type NamedListFilterScope = {
|
|
|
4422
4611
|
};
|
|
4423
4612
|
```
|
|
4424
4613
|
|
|
4614
|
+
## packages/types/src/nav-icon.ts
|
|
4615
|
+
|
|
4616
|
+
```ts
|
|
4617
|
+
const NAV_ICON_KEYS;
|
|
4618
|
+
```
|
|
4619
|
+
|
|
4425
4620
|
## packages/types/src/nav.ts
|
|
4426
4621
|
|
|
4427
4622
|
```ts
|
|
@@ -4488,8 +4683,6 @@ type SamplingConfig = {
|
|
|
4488
4683
|
};
|
|
4489
4684
|
};
|
|
4490
4685
|
type SensitiveFilterConfig = {
|
|
4491
|
-
redactedHeaders: string[];
|
|
4492
|
-
redactedQueryParams: string[];
|
|
4493
4686
|
redactedAttributeKeyPatterns: RegExp[];
|
|
4494
4687
|
};
|
|
4495
4688
|
```
|
|
@@ -4768,6 +4961,7 @@ type SecretsEditSection = {
|
|
|
4768
4961
|
## packages/types/src/screen-dashboard.ts
|
|
4769
4962
|
|
|
4770
4963
|
```ts
|
|
4964
|
+
const DASHBOARD_STAT_TONES: ["default", "positive", "ok", "warn", "negative"];
|
|
4771
4965
|
type DashboardChartKind = "timeseries" | "stacked-bars" | "segment-bars" | "stacked-area";
|
|
4772
4966
|
type DashboardChartRangeOption = { // One option of a stacked-area range switch.
|
|
4773
4967
|
value: string;
|
|
@@ -4779,6 +4973,13 @@ type DashboardChartRanges = {
|
|
|
4779
4973
|
default: string;
|
|
4780
4974
|
};
|
|
4781
4975
|
type DashboardChartTone = "positive" | "negative" | "active" | "neutral";
|
|
4976
|
+
type DashboardListRowLink = ({ screen: string; paramField?: string; screenField?: never; paramsField?: never; } | { screenField: string; paramsField?: string; screen?: never; paramField?: never; }) & { // Row link of a list panel: one fixed target screen (`screen`) or, when the rows point to different places, the screen named by each row (`screenField`).
|
|
4977
|
+
icon?: "arrow" | "chevron"; // "arrow" (default) draws ↗ for a jump to another place, "chevron" draws › for opening the row.
|
|
4978
|
+
};
|
|
4979
|
+
type DashboardListShowTotal = { // Texts of the "n of m" count in a list panel's subtitle; without `text` the default i18n text stands.
|
|
4980
|
+
text?: string; // i18n key, placeholders `{shown}` and `{total}`.
|
|
4981
|
+
narrowText?: string; // i18n key used instead of `text` below `sm`.
|
|
4982
|
+
};
|
|
4782
4983
|
type DashboardPanelGate = {
|
|
4783
4984
|
visibleWhen?: DashboardPanelVisibility;
|
|
4784
4985
|
};
|
|
@@ -4840,10 +5041,10 @@ type EntityListFacetExtraOption = { // An extra choice on a facet next to the fi
|
|
|
4840
5041
|
label: string; // i18n key.
|
|
4841
5042
|
values: string[]; // Option values this choice selects; `[]` selects nothing, i.e. no filter.
|
|
4842
5043
|
position?: "start" | "end"; // Where the chip sits relative to the field's own options.
|
|
5044
|
+
separatorAfter?: boolean; // Draws a divider line below this choice in the select dropdown (e.g. after a "needs action" bundle).
|
|
4843
5045
|
};
|
|
4844
|
-
type ListColumnDisplay = "bar" | "badge" | "datetime";
|
|
5046
|
+
type ListColumnDisplay = "bar" | "badge" | "datetime" | "button";
|
|
4845
5047
|
type ListPaginationMode = "pages" | "infinite" | false;
|
|
4846
|
-
type ListSortDir = "asc" | "desc";
|
|
4847
5048
|
type RowActionNavigateBase = {
|
|
4848
5049
|
kind: "navigate";
|
|
4849
5050
|
id: string;
|
|
@@ -4882,12 +5083,19 @@ type ExpandableRowGrouping = Omit<ListTableGrouping, "field" | "userChoice" | "f
|
|
|
4882
5083
|
## packages/types/src/screen-list-table.ts
|
|
4883
5084
|
|
|
4884
5085
|
```ts
|
|
5086
|
+
const LIST_COLUMN_PINS: ["left", "right"];
|
|
5087
|
+
const LIST_NARROW_FACETS: ["pills"];
|
|
5088
|
+
const LIST_TABLE_DENSITIES: ["comfortable", "compact", "relaxed"];
|
|
5089
|
+
const LIST_TABLE_FRAMES: ["card"];
|
|
5090
|
+
const LIST_TOOLBAR_ACTIONS_PLACEMENTS: ["header", "toolbar"];
|
|
4885
5091
|
type ListColumnPin = (typeof LIST_COLUMN_PINS)[number];
|
|
5092
|
+
type ListNarrowFacets = (typeof LIST_NARROW_FACETS)[number];
|
|
4886
5093
|
type ListTableDensity = (typeof LIST_TABLE_DENSITIES)[number];
|
|
4887
5094
|
type ListTableExportOptions = {
|
|
4888
5095
|
xlsx: true;
|
|
4889
5096
|
maxRows?: number; // Export is refused above this many rows.
|
|
4890
5097
|
};
|
|
5098
|
+
type ListTableFrame = (typeof LIST_TABLE_FRAMES)[number];
|
|
4891
5099
|
type ListTableGrouping = {
|
|
4892
5100
|
field?: string; // Start grouping.
|
|
4893
5101
|
collapsedWhen?: string | number | boolean | null; // Groups whose key equals this start collapsed and load no rows until opened.
|
|
@@ -4908,14 +5116,21 @@ type ListTableTotal = {
|
|
|
4908
5116
|
type MetricSpec = {
|
|
4909
5117
|
field: string;
|
|
4910
5118
|
label: string;
|
|
5119
|
+
labelField?: string; // Record field of the detail query holding the label text, e.g. "Rent from 01.12."; it replaces the static `label` while it holds a non-empty string.
|
|
4911
5120
|
navigate?: MetricNavigate;
|
|
5121
|
+
hideOnNarrow?: true; // Leaves the metric out below `sm`.
|
|
4912
5122
|
tone?: DashboardStatTone; // Tile color as on dashboard stat panels; not applied while the value is 0.
|
|
5123
|
+
toneField?: string; // Record field of the detail query holding a SelectOptionTone; a valid value overrides `tone`, also at value 0.
|
|
5124
|
+
subField?: string; // Record field of the detail query shown as a small line under the value; the value stays the number.
|
|
5125
|
+
subFieldNarrow?: string; // Record field shown instead of `subField` below `sm` ("of 2,850 €" instead of "0 of 2,850.00 €").
|
|
4913
5126
|
icon?: NavIconKey; // Icon chip of the tile; only drawn with `metricsStyle: "tiles"`.
|
|
4914
5127
|
format?: FormatSpec; // Formats the displayed value (e.g. `date`, `enumOption`); the tone still resolves on the raw value.
|
|
4915
5128
|
};
|
|
4916
5129
|
type RecordHeaderSpec = {
|
|
4917
5130
|
title: string;
|
|
5131
|
+
shortTitle?: string; // Field holding a short title for the desktop top bar ("Orders › SO-10482 ● processing"); the body keeps the full `title` as the h1.
|
|
4918
5132
|
subtitle?: string | RecordHeaderSubtitlePart[]; // Field name, or several parts (field name or `{ field, navigate }`) joined by a separator; parts with an empty value are dropped.
|
|
5133
|
+
narrowSubtitle?: string; // Field holding a plain-text subtitle shown instead of `subtitle` below `sm` (e.g. "Main St 12, Berlin · 3 rooms").
|
|
4919
5134
|
status?: string;
|
|
4920
5135
|
statusFormat?: FormatSpec; // Formats the badge text (typically `enumOption` with a `keyPrefix`); tones still resolve on the raw value.
|
|
4921
5136
|
subtitleHref?: string; // Record field holding an absolute http(s) URL.
|
|
@@ -4926,6 +5141,15 @@ type RecordHeaderSpec = {
|
|
|
4926
5141
|
};
|
|
4927
5142
|
```
|
|
4928
5143
|
|
|
5144
|
+
## packages/types/src/screen-record-guidance.ts
|
|
5145
|
+
|
|
5146
|
+
```ts
|
|
5147
|
+
type RecordGuidanceAction = RowAction & { // A banner or step action.
|
|
5148
|
+
hideIcon?: true;
|
|
5149
|
+
narrowLabel?: string; // i18n key shown as the button label below `sm` (a shorter word, e.g. "Plan" for "Plan handover").
|
|
5150
|
+
};
|
|
5151
|
+
```
|
|
5152
|
+
|
|
4929
5153
|
## packages/types/src/screen.ts
|
|
4930
5154
|
|
|
4931
5155
|
```ts
|