@cosmicdrift/kumiko-framework 0.415.0 → 0.416.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/api/framework-engine.md +37 -5
- package/agents/api/framework-ui-types.md +59 -3
- package/agents/api/renderer-web.md +7 -1
- package/agents/api/types.md +21 -2
- package/agents/api.md +1 -1
- package/agents/boot-rules.md +33 -3
- package/agents/examples/embedded.md +24 -1
- package/agents/examples/handbook-knowledge.md +129 -0
- package/agents/examples/signature.md +186 -0
- package/agents/examples/writeform-section.md +1 -0
- package/agents/examples.md +2 -0
- package/agents/features-index.md +4 -0
- package/agents/features.md +14 -0
- package/dist/api/server-routes.js +2 -0
- package/dist/db/table-builder.js +3 -1
- package/dist/engine/boot-validator/boot-phases.js +5 -0
- package/dist/engine/boot-validator/boot-rules.d.ts +129 -4
- package/dist/engine/boot-validator/cross-tenant-file-read.d.ts +3 -0
- package/dist/engine/boot-validator/cross-tenant-file-read.js +19 -0
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +10 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +10 -0
- package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +16 -1
- package/dist/engine/boot-validator/list-row-guidance-rules.js +16 -1
- package/dist/engine/boot-validator/list-row-guidance.d.ts +7 -0
- package/dist/engine/boot-validator/list-row-guidance.js +30 -0
- package/dist/engine/boot-validator/query-output-columns.js +18 -0
- package/dist/engine/boot-validator/query-output-guidance.js +2 -0
- package/dist/engine/boot-validator/query-refs.js +4 -1
- package/dist/engine/boot-validator/relative-time-format.d.ts +1 -0
- package/dist/engine/boot-validator/relative-time-format.js +51 -0
- package/dist/engine/boot-validator/screens-actions-rules.d.ts +16 -1
- package/dist/engine/boot-validator/screens-actions-rules.js +16 -1
- package/dist/engine/boot-validator/screens-actions.js +55 -15
- package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +2 -1
- package/dist/engine/boot-validator/screens-dashboard-narrow.js +43 -4
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +12 -2
- package/dist/engine/boot-validator/screens-dashboard-rules.js +12 -2
- package/dist/engine/boot-validator/screens-dashboard.js +2 -1
- package/dist/engine/boot-validator/screens-forms-layout-rules.d.ts +5 -0
- package/dist/engine/boot-validator/screens-forms-layout-rules.js +5 -0
- package/dist/engine/boot-validator/screens-forms-rules.d.ts +60 -0
- package/dist/engine/boot-validator/screens-forms-rules.js +60 -0
- package/dist/engine/boot-validator/screens-forms.d.ts +1 -1
- package/dist/engine/boot-validator/screens-forms.js +108 -2
- package/dist/engine/boot-validator/screens-kind-config-edit.js +1 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +5 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +5 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +30 -0
- package/dist/engine/boot-validator/screens-lists-rules.d.ts +5 -0
- package/dist/engine/boot-validator/screens-lists-rules.js +5 -0
- package/dist/engine/boot-validator/screens-lists.js +4 -1
- package/dist/engine/build-config-feature-schema.js +5 -35
- package/dist/engine/config-access-rules.d.ts +3 -0
- package/dist/engine/config-access-rules.js +34 -0
- package/dist/engine/factories.d.ts +2 -0
- package/dist/engine/project-app-schema-for-roles.js +2 -0
- package/dist/files/file-routes.d.ts +2 -0
- package/dist/files/file-routes.js +85 -22
- package/dist/files/foreign-tenant-file-read.d.ts +13 -0
- package/dist/files/foreign-tenant-file-read.js +64 -0
- package/dist/i18n/required-surface-keys.js +26 -6
- package/dist/ui-types/index.d.ts +1 -1
- package/package.json +3 -3
- package/src/changes.json +42 -0
package/dist/ui-types/index.d.ts
CHANGED
|
@@ -11,7 +11,7 @@ export type { EmbeddedDerivedCellDef, EntityDefinition, FieldDefinition, Options
|
|
|
11
11
|
export type { AccessRule } from "../engine/types/handlers.ts";
|
|
12
12
|
export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers.ts";
|
|
13
13
|
export type { IconKey, NavDefinition, NavIconKey } from "../engine/types/nav.ts";
|
|
14
|
-
export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessItems, ActionFormSuccessLink, ConfigEditAction, ConfigEditScreenDefinition, CustomScreenDefinition, DashboardChartMarkerKind, DashboardChartPanel, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListFooterLink, DashboardListNarrow, DashboardListPanel, DashboardListRowToneMarker, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelNarrow, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRefresh, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupLayout, DashboardStatGroupLink, DashboardStatGroupNarrow, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, EditExtensionSection, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditScreenDefinition, EntityListFacetConfig, EntityListScreenDefinition, FieldAffix, FieldCondition, FieldFillAction, FieldIconKey, FieldRenderer, FormWidth, ListBulkAction, ListColumnHint, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListRowDecoration, ListSortOption, ListSortSpec, ListTableOptions, ListTableSummaryRow, ListToolbarActionsPlacement, MetricNavigate, PlatformComponent, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordBannerSpec, RecordBreadcrumbItem, RecordBreadcrumbSpec, RecordHeaderSubtitlePart, RecordNotice, RecordProgress, RecordProgressSpec, RecordProgressStep, RecordStep, RecordStepsSpec, RecordSummarySpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, ScreenSlots, ScreenVisibility, SecretMintConfirmStep, SecretMintScreenDefinition, SecretsEditScreenDefinition, ToolbarAction, } from "../engine/types/screen.ts";
|
|
14
|
+
export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessItems, ActionFormSuccessLink, ConfigEditAction, ConfigEditScreenDefinition, CustomScreenDefinition, DashboardChartMarkerKind, DashboardChartPanel, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardLayout, DashboardListFooterLink, DashboardListNarrow, DashboardListPanel, DashboardListRowToneMarker, DashboardMoneyParam, DashboardPanelColumn, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelNarrow, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRefresh, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupLayout, DashboardStatGroupLink, DashboardStatGroupNarrow, DashboardStatGroupPanel, DashboardStatPanel, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, EditExtensionSection, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditStepListSection, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditScreenDefinition, EntityListFacetConfig, EntityListScreenDefinition, FieldAffix, FieldAiAssist, FieldAiAssistChip, FieldCondition, FieldFillAction, FieldIconKey, FieldRenderer, FieldTextRef, FieldValueChips, FormWidth, ListBulkAction, ListColumnHint, ListColumnSpec, ListEmptyStateSpec, ListFacetSpec, ListRowDecoration, ListSortOption, ListSortSpec, ListTableOptions, ListTableSummaryRow, ListToolbarActionsPlacement, MetricNavigate, PlatformComponent, ProjectionDetailInitialTab, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordBannerSpec, RecordBreadcrumbItem, RecordBreadcrumbSpec, RecordHeaderSubtitlePart, RecordNotice, RecordProgress, RecordProgressSpec, RecordProgressStep, RecordStep, RecordStepsSpec, RecordSummarySpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ScreenDefinition, ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, ScreenSlots, ScreenVisibility, SecretMintConfirmStep, SecretMintScreenDefinition, SecretsEditScreenDefinition, StepListItem, ToolbarAction, } from "../engine/types/screen.ts";
|
|
15
15
|
export { MAX_BULK_SELECTION } from "../engine/types/screen.ts";
|
|
16
16
|
export type { TargetRef } from "../engine/types/target-ref.ts";
|
|
17
17
|
export type { TreeAction } from "../engine/types/tree-node.ts";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cosmicdrift/kumiko-framework",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.416.0",
|
|
4
4
|
"description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
|
|
@@ -204,7 +204,7 @@
|
|
|
204
204
|
"./package.json": "./package.json"
|
|
205
205
|
},
|
|
206
206
|
"dependencies": {
|
|
207
|
-
"@cosmicdrift/kumiko-types": "0.
|
|
207
|
+
"@cosmicdrift/kumiko-types": "0.416.0",
|
|
208
208
|
"bullmq": "^5.81.5",
|
|
209
209
|
"hono": "^4.13.14",
|
|
210
210
|
"i18next": "^26.5.12",
|
|
@@ -226,7 +226,7 @@
|
|
|
226
226
|
}
|
|
227
227
|
},
|
|
228
228
|
"devDependencies": {
|
|
229
|
-
"@cosmicdrift/kumiko-testing": "0.
|
|
229
|
+
"@cosmicdrift/kumiko-testing": "0.416.0",
|
|
230
230
|
"bun-types": "^1.4.4",
|
|
231
231
|
"fflate": "^0.8.3",
|
|
232
232
|
"meilisearch": "^0.62.0",
|
package/src/changes.json
CHANGED
|
@@ -1,4 +1,46 @@
|
|
|
1
1
|
[
|
|
2
|
+
{
|
|
3
|
+
"version": "0.416.0",
|
|
4
|
+
"type": "improvement",
|
|
5
|
+
"title": "actionForm redirect with searchParams to custom screens",
|
|
6
|
+
"detail": "The object form of `redirect` takes `searchParams` (`{ cmd: \"threadId\" }` opens the target with `?cmd=<threadId>`); each value names a flat field in the success payload and a missing or non-string field leaves its param out. `idFrom` is now optional (default \"id\" as with the string redirect), so a redirect to a custom screen needs no record id. Boot rejects `searchParams` on non-actionForm redirects and empty keys or fields; `idFrom` on a target without an id stays rejected."
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"version": "0.416.0",
|
|
10
|
+
"type": "improvement",
|
|
11
|
+
"title": "Board options for dashboards, projectionDetail and forms",
|
|
12
|
+
"detail": "Dashboard `layout: \"main-side\"` lays panels out in a two-thirds main and a one-third side column (`column: \"side\"` on a panel; below sm one column in `narrowOrder`); a boot rule rejects `column` without that layout. Text panel `icon` (an extension-section component) leads the text. List column `variant: \"primary\"` (with `display: \"button\"`) draws the filled button. A stat-group child with `hideOnNarrow` is unmounted on phones; the boot rule now only rejects a group whose children all hide. projectionDetail `steps.moreActionsLabel` (i18n key before each step's further actions) and `steps.visibleWhen`, `initialTab: [{ when, tab }]` (first matching rule wins, else the first visible tab; an explicit `?tab=` wins over it), `footerHint` (i18n key, left of the footer actions, hidden on phones; needs `footerActions`) and `slots.afterForm` under the active tab's sections (the slot component gets `activeTabId`; it renders on every RenderEdit screen that declares it). `footerActions` are pinned in the phone footer next to the primary action instead of the more-menu. `layout.allRequiredHint: false` keeps the per-field asterisks instead of the all-fields-required hint. actionForm `fieldLabels` and `fieldDescriptions` take `{ key, params: { placeholder: \"fieldName\" } }`, filled from the form values including hidden fields; a description with an empty param value is not shown; a boot rule rejects params that name no field of the form. `aiAssist.prompt` submits with Enter and the Apply button and its `kumiko.field.aiAssist.apply` key are removed. `valueChips` format the text by field type (money with locale and currency, numbers with locale) and render the chip equal to the current value pressed with a check mark. Client row action `successMessage: false` shows no toast."
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"version": "0.416.0",
|
|
16
|
+
"type": "improvement",
|
|
17
|
+
"title": "Cross-tenant file reads declared per entity",
|
|
18
|
+
"detail": "`crossTenantFileRead: { query, reason }` on an entity lets users of another tenant read its attached files when the named query handler, run as that user with `{ id: <entityId> }`, returns the record with that id. Covers GET /files/:id, /variant/:name, /download-url, /meta and GET /files/meta; variants are rendered and cached in the owning tenant. The query alone decides, so privilegedRoles and a custom accessGuard never open a foreign tenant's file. Anonymous users are always refused, delete and upload stay tenant-equal. Boot rules `files/cross-tenant-read-query-unregistered` and `files/cross-tenant-read-reason-missing`."
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"version": "0.416.0",
|
|
22
|
+
"type": "fix",
|
|
23
|
+
"title": "jsonb emptyValue \"array\" on projection tables",
|
|
24
|
+
"detail": "A projection table built with `buildEntityTable` gave a jsonb field with `emptyValue: \"array\"` the default `{}`, while the entity's migration meta used `[]`. `kumiko-schema generate` then refused the table as declared with diverging columns. Both paths now use `[]`."
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"version": "0.416.0",
|
|
28
|
+
"type": "improvement",
|
|
29
|
+
"title": "ConfigMask.readOnly shows a key without an input in the settings hub",
|
|
30
|
+
"detail": "mask: { title, readOnly: true } keeps the key on the generated settings screen as a read-only field. A readOnly key that is also required fails at boot, since nobody could fill it."
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"version": "0.416.0",
|
|
34
|
+
"type": "fix",
|
|
35
|
+
"title": "Boot validation checks the relativeTime timeZone",
|
|
36
|
+
"detail": "A relativeTime format with an unknown timeZone such as Europe/Berln fails at boot instead of throwing when the cell renders."
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"version": "0.416.0",
|
|
40
|
+
"type": "improvement",
|
|
41
|
+
"title": "Form helpers, list pills, phone cells, pinned footer actions and photo grid",
|
|
42
|
+
"detail": "Form fields take `aiAssist: { query, resultField, chips: [{ label, params }], prompt: { param, placeholder } }` (an active chip's `params` and the typed text are sent to the registered `query` together with the form's load/prefill payload; chips stack, `resultField` of the result is written into the field; labels and placeholder are i18n keys) and `valueChips: { from }` (chips from an array field of the form). actionForm gets `fieldDescriptions` (field to i18n key, help text under the field) and `formErrorOnTop`. List columns get `pillField` and `pillToneField` (a second pill beside the value) and `{ format: \"phone\" }` (a tel: link). projectionDetail `footerActions` moves actions from the header into the pinned footer (`align: \"start\"` on a declared action sets it on the left), relatedList `photoGrid: { imageField, captionField }` draws rows as image tiles with their row actions (new optional `PhotoGrid` primitive), and `summary.icon` leads the record sentence with an icon. Boot rules reject unknown fields, wrong field types and invalid chips. Write-only fields no longer close an open Replace when the record reloads. projectionDetail: adjacent sections sharing one `id` form one tab (the first section gives label and count). New section kind `{ kind: \"stepList\", field, title? }` renders a numbered vertical step list from an array field of the detail query (`StepListItem`: title, status, statusTone, description; optional `StepList` primitive). Every projectionDetail section takes `visibleWhen: { field, eq | ne | in | notIn }` evaluated on the record; a hidden section drops out of the tab strip. actionForm `infoBand` (i18n key, banner with a sparkles icon above the fields) and `fieldBadges: { field: { label, tone } }` (badge next to the label); multiSelect `display: \"chips\"`; `aiAssist.contextFields` sends other form fields in the query payload and re-runs the query when they change. A list that shows its emptyState has no `0 entries` footer. DefaultDrawer is a bottom sheet (max 90% height) on narrow viewports. actionForm `summary.paramsFromLoad: string[]` fills summary placeholders from fields of the load result (boot rule: field must be in the load query's outputSchema). actionForm `load: { passPrefill: true }` sends the drawer's prefill values (e.g. `vehicleId`) in the load payload; `aiAssist.noteField` shows a short note from the query result under the field. Boot rules cover stepList field, visibleWhen field, unknown fieldBadges and contextFields."
|
|
43
|
+
},
|
|
2
44
|
{
|
|
3
45
|
"version": "0.415.0",
|
|
4
46
|
"type": "fix",
|