@cosmicdrift/kumiko-renderer 0.377.0 → 0.379.0

package/dist/components/grid-cell-for-field.js

@@ -29,10 +29,14 @@ export function fieldCellWidth(field) {
         return "full";
     return FIELD_CELL_WIDTH_BY_TYPE[field.type] ?? "text";
 }
-export function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, fillDisabled, }) {
+export function GridCellForField({ field, columns, issues, onChange, GridCell, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, flow, layout, accent, fillDisabled, sectionTitle, }) {
     // RenderField renders nothing for a hidden field, but the GridCell around it still claims the row.
     if (!field.visible)
         return null;
+    const hideLabel = sectionTitle !== undefined &&
+        field.type === "embedded" &&
+        field.embeddedListCells !== undefined &&
+        field.label === sectionTitle;
     const effectiveSpan = field.span !== undefined ? Math.min(field.span, columns) : 1;
-    return (_jsx(GridCell, { span: effectiveSpan, ...(flow === true && { width: fieldCellWidth(field) }), children: _jsx(RenderField, { field: field, ...(issues !== undefined && { issues }), onChange: onChange, featureName: featureName, ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), allIssues: allIssues, valueDisplay: valueDisplay, row: row, ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), ...(fillDisabled === true && { fillDisabled }) }) }));
+    return (_jsx(GridCell, { span: effectiveSpan, ...(flow === true && { width: fieldCellWidth(field) }), children: _jsx(RenderField, { field: field, ...(issues !== undefined && { issues }), onChange: onChange, featureName: featureName, ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), allIssues: allIssues, valueDisplay: valueDisplay, row: row, ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), ...(fillDisabled === true && { fillDisabled }), ...(hideLabel && { hideLabel }) }) }));
 }

package/dist/components/list-empty-state.d.ts

@@ -5,10 +5,13 @@ export type ListEmptyStateContent = {
     readonly description?: string;
     readonly action?: RenderEditAction;
 };
-export declare function ListEmptyStateBody({ content, narrowed, createButton, translate, }: {
+export declare function ListEmptyStateBody({ content, narrowed, defaultFilterActive, onShowAll, createButton, translate, }: {
     readonly content: ListEmptyStateContent | undefined;
     /** A search term or changed filter produced the empty result, so "create the first one" would mislead. */
     readonly narrowed: boolean;
+    /** A default filter is on and nothing else narrows: rows may exist outside it. */
+    readonly defaultFilterActive?: boolean;
+    readonly onShowAll?: () => void;
     readonly createButton: ReactNode;
     readonly translate: (key: string) => string;
 }): ReactNode;

package/dist/components/list-empty-state.js

@@ -2,11 +2,14 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useState } from "react";
 import { usePrimitives } from "../primitives.js";
 import { RenderEditActionButton } from "./render-edit-action-button.js";
-export function ListEmptyStateBody({ content, narrowed, createButton, translate, }) {
+export function ListEmptyStateBody({ content, narrowed, defaultFilterActive = false, onShowAll, createButton, translate, }) {
     const { Text, Button, Dialog, Banner } = usePrimitives();
     const [actionError, setActionError] = useState(null);
     if (narrowed)
         return _jsx(Text, { children: translate("kumiko.list.empty.filtered") });
+    if (defaultFilterActive) {
+        return (_jsxs(_Fragment, { children: [_jsx(Text, { children: translate("kumiko.list.empty.defaultFiltered") }), onShowAll !== undefined && (_jsx(Button, { variant: "secondary", onClick: onShowAll, testId: "render-list-empty-show-all", children: translate("kumiko.list.empty.showAll") }))] }));
+    }
     const description = content === undefined ? translate("kumiko.list.empty.hint") : content.description;
     return (_jsxs(_Fragment, { children: [_jsx(Text, { children: content?.title ?? translate("kumiko.list.empty.title") }), description !== undefined && _jsx(Text, { variant: "small", children: description }), content?.action !== undefined && (_jsx(RenderEditActionButton, { action: content.action, Button: Button, Dialog: Dialog, onError: setActionError })), actionError !== null && (_jsx(Banner, { variant: "error", testId: "render-list-empty-state-action-error", children: actionError })), createButton] }));
 }

package/dist/components/reference-create-dialog.js

@@ -48,5 +48,5 @@ export function ReferenceCreateDialog({ open, onClose, onCreated, featureName, s
     };
     if (!open)
         return null;
-    return (_jsx(Modal, { open: open, onOpenChange: (next) => !next && onClose(), title: t("kumiko.actions.create"), children: currencyLoading ? (_jsx(Banner, { padded: true, variant: "loading", testId: "reference-create-dialog-loading", children: "Loading\u2026" })) : (_jsx(RenderEdit, { screen: screen, entity: entity, featureName: featureName, initial: initial, writeCommand: writeCommand, onSubmit: handleSubmitted, onCancel: onClose, ...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel }) })) }));
+    return (_jsx(Modal, { open: open, onOpenChange: (next) => !next && onClose(), title: t("kumiko.actions.create"), children: currencyLoading ? (_jsx(Banner, { padded: true, variant: "loading", testId: "reference-create-dialog-loading", children: t("kumiko.widget.loading") })) : (_jsx(RenderEdit, { screen: screen, entity: entity, featureName: featureName, initial: initial, writeCommand: writeCommand, onSubmit: handleSubmitted, onCancel: onClose, ...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel }) })) }));
 }

package/dist/components/related-list-section.js

@@ -254,10 +254,13 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
             : { [section.parentParam ?? "id"]: parentId },
         record,
         host,
+        access: { appFeatures, userRoles },
         ...(onOpenDrawer !== undefined && {
             openDrawer: (action) => onOpenDrawer(action, undefined),
         }),
     }), [
+        appFeatures,
+        userRoles,
         section.toolbarActions,
         section.parentParam,
         section.parentFilter,
@@ -319,7 +322,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
     const truncated = rowsQuery.data !== null &&
         typeof rowsQuery.data.nextCursor === "string" &&
         (rowsQuery.data.total === undefined || rowsQuery.data.total > rowsQuery.data.rows.length);
-    const content = rowsQuery.loading && rowsQuery.data === null ? (_jsx(Banner, { padded: true, variant: "loading", testId: "related-list-loading", children: "Loading\u2026" })) : rowsQuery.error ? (_jsx(Banner, { padded: true, variant: "error", testId: "related-list-error", children: dispatcherErrorText(rowsQuery.error, effectiveTranslate) })) : (_jsxs(_Fragment, { children: [truncated && (_jsx(Banner, { variant: "info", testId: "related-list-truncated", children: effectiveTranslate("kumiko.list.related-list-truncated", {
+    const content = rowsQuery.loading && rowsQuery.data === null ? (_jsx(Banner, { padded: true, variant: "loading", testId: "related-list-loading", children: t("kumiko.widget.loading") })) : rowsQuery.error ? (_jsx(Banner, { padded: true, variant: "error", testId: "related-list-error", children: dispatcherErrorText(rowsQuery.error, effectiveTranslate) })) : (_jsxs(_Fragment, { children: [truncated && (_jsx(Banner, { variant: "info", testId: "related-list-truncated", children: effectiveTranslate("kumiko.list.related-list-truncated", {
                     count: sortedRows.length,
                 }) })), emptyStateActionError !== null && (_jsx(Banner, { variant: "error", testId: "related-list-empty-state-action-error", children: emptyStateActionError })), _jsx(PageHeaderSlotAvailableProvider, { value: false, children: _jsx(RenderList, { screen: listScreen, entity: entity, rows: sortedRows, featureName: listFeatureName ?? featureName, translate: effectiveTranslate, ...(section.description !== undefined && { description: section.description }), ...(section.itemNoun !== undefined && { itemNounKey: section.itemNoun }), sort: sort, onSortChange: setSort, ...(section.searchable === true && {
                         searchable: true,

package/dist/components/render-edit-logic.d.ts

@@ -3,7 +3,7 @@ export declare function hasEditableSection(sections: readonly EditSectionViewMod
 export declare function resolveExtensionEntityId(entityIdProp: string | null | undefined, vmId: string | null): string | null;
 export declare function shouldNotifyCaller(result: SubmitResult<unknown>, extensionsPersisted: boolean): boolean;
 export declare function issueRootField(path: string): string;
-export declare function hasIssueWithoutRenderedField(issuePaths: readonly string[], sections: readonly EditSectionViewModel[]): boolean;
+export declare function hasIssueWithoutRenderedField(issuePaths: readonly string[], sections: readonly EditSectionViewModel[], derivedTargets?: ReadonlySet<string>): boolean;
 export declare function hasIssueWithoutVisibleField(issuePaths: readonly string[], fields: readonly EditFieldViewModel[]): boolean;
 export declare function findFirstErroringSectionIndex(sections: readonly EditSectionViewModel[], issuePaths: readonly string[]): number | undefined;
 export declare function filterEditSections(sections: readonly EditSectionViewModel[], fieldsFilter: readonly string[] | undefined): readonly EditSectionViewModel[];

package/dist/components/render-edit-logic.js

@@ -32,9 +32,15 @@ export function issueRootField(path) {
     return path.split(".")[0] ?? path;
 }
 // No issues at all counts as unmatched, so the caller keeps the banner.
-export function hasIssueWithoutRenderedField(issuePaths, sections) {
+// `derivedTargets` are head fields the form computes (actionForm `derive`): an
+// issue on one is a knock-on of another issue (an empty list leaves the total
+// without a value), nobody can fix it there. It is ignored while another issue
+// exists, so the banner does not bury the real one; alone it keeps the banner.
+export function hasIssueWithoutRenderedField(issuePaths, sections, derivedTargets = new Set()) {
+    const fixablePaths = issuePaths.filter((path) => !derivedTargets.has(issueRootField(path)));
+    const paths = fixablePaths.length > 0 ? fixablePaths : issuePaths;
     const renderedFields = sections.flatMap((s) => s.kind === "fields" && s.visible ? s.fields : []);
-    return hasIssueWithoutVisibleField(issuePaths, renderedFields);
+    return hasIssueWithoutVisibleField(paths, renderedFields);
 }
 export function hasIssueWithoutVisibleField(issuePaths, fields) {
     if (issuePaths.length === 0)

package/dist/components/render-edit-types.d.ts

@@ -1,4 +1,4 @@
-import type { ActionFormFooterAction, EntityDefinition, EntityEditScreenDefinition, IconKey, RowAction, RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
+import type { ActionFormFooterAction, EntityDefinition, EntityEditScreenDefinition, FormDerivationScreen, IconKey, RowAction, RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
 import type { ReactNode } from "react";
 import type * as z from "zod";
 import type { DispatcherError, FormSnapshot, FormValues, SubmitResult, Translate } from "../headless/index.ts";
@@ -204,6 +204,12 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
      *  `disabled`, which locks the whole form. For a gate the host owns, e.g.
      *  an acknowledgement checkbox in `leadContent`. */
     readonly submitBlocked?: boolean;
+    /** actionForm `derive`: derived fields are recomputed into the form state on every
+     *  change and render read-only. */
+    readonly formDerivation?: FormDerivationScreen;
+    /** QN of the actionForm screen this form renders; its file fields upload as pending for that
+     *  screen. Unset for entityEdit and for secretMint/confirm forms, which take no uploads. */
+    readonly actionFormScreenQn?: string;
     /** Show the unsaved-changes footer (count, Discard, "Save changes") even
      *  without an entity id or a screen-height form — for hosts that edit an
      *  existing server-side record through `customSubmit` (configEdit, also when

package/dist/components/render-edit.js

@@ -2,6 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { evalFieldCondition, isFieldsEditSection, normalizeEditField, PROJECTION_DETAIL_ENTITY, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { computeEditViewModel, groupIssuesByPath, relevantFieldIssues, zodErrorToFieldIssues, } from "../headless/index.js";
+import { changedDerivedValues } from "./form-derivation-patch.js";
 import { RenderEditActionButton } from "./render-edit-action-button.js";
 import { AllFieldsRequiredProvider } from "./render-field.js";
 import { useActionMenuItems } from "./use-action-menu-items.js";
@@ -15,6 +16,7 @@ import { formatWhen } from "../format-when.js";
 import { useForm } from "../hooks/use-form.js";
 import { useTranslation } from "../i18n.js";
 import { useInsideDrawer } from "../inside-drawer.js";
+import { useUnsavedInputSource } from "../leave-guard.js";
 import { usePageHeaderCompact, usePageHeaderSlotAvailable } from "../page-header-slot.js";
 import { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, usePrimitives, } from "../primitives.js";
 import { GridCellForField } from "./grid-cell-for-field.js";
@@ -29,7 +31,7 @@ const FORM_DRAFT_GET = "form-draft:query:get";
 const FORM_DRAFT_SAVE = "form-draft:write:save";
 const FORM_DRAFT_DISCARD = "form-draft:write:discard";
 const FORM_DRAFT_LIST = "form-draft:query:list";
-// Mirrors bundled-features/src/form-draft/constants.ts's FORM_DRAFT_KEY_MAX_LENGTH
+// Mirrors bundled-features/src/form-draft/web/constants.ts's FORM_DRAFT_KEY_MAX_LENGTH
 // — same hardcoding rationale as the QNs above (no dependency on that package).
 const FORM_DRAFT_KEY_MAX_LENGTH = 256;
 // Trailing-edge debounce for patch()-triggered draft saves (#1914). A single
@@ -48,7 +50,7 @@ function newDraftPrefix(screenId) {
     return `${screenId}:new:`;
 }
 // `crypto.randomUUID` is missing in non-secure contexts and React Native/Hermes
-// without a polyfill — guard like dispatcher-live.ts's generateRequestId.
+// without a polyfill — guard like generateRequestId in headless/dispatcher/request-id.ts.
 function mintDraftId() {
     const webCrypto = propertyOf(globalThis, "crypto");
     const randomUUID = propertyOf(webCrypto, "randomUUID");
@@ -229,7 +231,7 @@ function resolveTitleTemplate(template, values, translate, fallback) {
     return translate(template, values);
 }
 export function RenderEdit(props) {
-    const { screen, entity, featureName, initial, writeCommand, translate: translateProp, ctx, schema, onSubmit, payloadMode = "values", buildPayload, serverFieldPathPrefix, onDelete, onCancel, onReload, refreshToken, onDirtyChange, onCopyLink, actions, menuActions, onRelatedListDrawerAction, submitLabel, submitVariant, submitWithoutChanges, footerActions, summary, labelAppendix, fieldAppendix, fieldAppendixPlacement, fieldDescription, fieldAccent, markChangedFields = false, entityId: entityIdProp, extensionInitialValues, onChange, onControlsReady, fields: fieldsFilter, disabled: disabledProp = false, viewMode = false, hideActions, valueDisplay = "form", hideSectionTitles, fillScreenHeight, dirtyFooter, validateOnChange, headerRegion, buildSectionActions, leadContent, submitBlocked = false, } = props;
+    const { screen, entity, featureName, initial, writeCommand, translate: translateProp, ctx, schema, onSubmit, payloadMode = "values", buildPayload, serverFieldPathPrefix, onDelete, onCancel, onReload, refreshToken, onDirtyChange, onCopyLink, actions, menuActions, onRelatedListDrawerAction, submitLabel, submitVariant, submitWithoutChanges, footerActions, summary, labelAppendix, fieldAppendix, fieldAppendixPlacement, fieldDescription, fieldAccent, markChangedFields = false, entityId: entityIdProp, extensionInitialValues, onChange, onControlsReady, fields: fieldsFilter, disabled: disabledProp = false, viewMode = false, hideActions, valueDisplay = "form", hideSectionTitles, fillScreenHeight, dirtyFooter, validateOnChange, headerRegion, buildSectionActions, leadContent, submitBlocked = false, formDerivation, actionFormScreenQn, } = props;
     // View mode is a locked form, so everything keyed on `disabled` follows.
     const disabled = disabledProp || viewMode;
     const i18nScreenId = props.i18nScreenId ?? screen.id;
@@ -254,6 +256,7 @@ export function RenderEdit(props) {
     const [confirmDeleteOpen, setConfirmDeleteOpen] = useState(false);
     const [linkCopied, setLinkCopied] = useState(false);
     const [isSubmitting, setIsSubmitting] = useState(false);
+    const [focusFirstErrorKey, setFocusFirstErrorKey] = useState(0);
     const [formError, setFormError] = useState(null);
     // Only a submit's validation/server error is cleared by editing; a delete
     // rejection and a version conflict (reload is the way out) stay put.
@@ -304,9 +307,12 @@ export function RenderEdit(props) {
     // never enters `fields`/`controller.getSnapshot().values` — there is no
     // draft-blob-covered state left for persistExtensions() to compete over.
     const [extensionDirty, setExtensionDirty] = useState(false);
+    // Mirror for the leave guard: it must see "saved" before React re-renders.
+    const extensionDirtyRef = useRef(false);
     const [hasExtensionRegistrations, setHasExtensionRegistrations] = useState(false);
     const [extensionErrorKey, setExtensionErrorKey] = useState(null);
     const { registry: extensionFormRegistry, runAll: runExtensionSubmits } = useExtensionFormHost(({ anyDirty, hasRegistrations }) => {
+        extensionDirtyRef.current = anyDirty;
         setExtensionDirty(anyDirty);
         setHasExtensionRegistrations(hasRegistrations);
     });
@@ -367,6 +373,16 @@ export function RenderEdit(props) {
         ...(ctx !== undefined && { ctx }),
         ...(submitConfig !== undefined && { submit: submitConfig }),
     });
+    // Derived fields are written into form state (not only displayed) so required
+    // validation and the submit payload carry them; only a real change is set, which
+    // keeps this from looping.
+    useEffect(() => {
+        if (formDerivation === undefined)
+            return;
+        const patch = changedDerivedValues(snapshot.values, formDerivation);
+        if (patch !== undefined)
+            controller.setValues(patch); // @cast-boundary form-values
+    }, [snapshot.values, formDerivation, controller]);
     // Wired at the user-input boundary, not in controller.setField: computed
     // fields, prefill, draft restore and action patches also call setValues
     // after a failed submit and must not wipe the errors.
@@ -541,6 +557,9 @@ export function RenderEdit(props) {
     useEffect(() => {
         onDirtyChangeRef.current?.(hasUnsavedInput);
     }, [hasUnsavedInput]);
+    // Draft wizards keep their input server-side, so leaving loses nothing.
+    const persistsDraft = isWizard && screen.layout.draft === true;
+    useUnsavedInputSource(() => !persistsDraft && (controller.getSnapshot().isDirty || extensionDirtyRef.current));
     useEffect(() => {
         // skip: this screen does not persist a draft.
         if (!draftEnabled || dispatcher === undefined)
@@ -654,7 +673,11 @@ export function RenderEdit(props) {
         featureName,
         mode: writeVerb,
         ...(!isCreateMode && entityIdProp != null && { entityId: entityIdProp }),
+        ...(formDerivation !== undefined && { derivation: formDerivation }),
+        ...(actionFormScreenQn !== undefined && { actionFormScreenQn }),
     }), [
+        formDerivation,
+        actionFormScreenQn,
         screen,
         entity,
         snapshot.values,
@@ -962,6 +985,7 @@ export function RenderEdit(props) {
                 // Same discard as the main path: an extension-only save is still a
                 // successful submit, so the draft must not survive it.
                 if (await persistExtensions()) {
+                    extensionDirtyRef.current = false;
                     submittedRef.current = true;
                     await discardDraft();
                 }
@@ -1023,8 +1047,11 @@ export function RenderEdit(props) {
                     await discardDraft();
                 }
                 extensionsPersisted = await persistExtensions();
+                if (extensionsPersisted)
+                    extensionDirtyRef.current = false;
             }
             else if (result.validationBlocked) {
+                setFocusFirstErrorKey((key) => key + 1);
                 // Root-level `.refine()`/cross-field issues from controller.validate()
                 // — same "jump to the erroring step" treatment as a server field
                 // error below, sourced from the freshly-validated snapshot.
@@ -1037,6 +1064,8 @@ export function RenderEdit(props) {
             else {
                 const fieldIssues = result.error.details?.fields ?? [];
                 const issuePaths = fieldIssues.map((i) => i.path);
+                if (fieldIssues.length > 0)
+                    setFocusFirstErrorKey((key) => key + 1);
                 // controller.submit() writes server issues into the controller itself;
                 // customSubmit bypasses it, so push them here to reach the fields.
                 if (customSubmit !== undefined && fieldIssues.length > 0) {
@@ -1056,7 +1085,9 @@ export function RenderEdit(props) {
                 }
                 setExtraDeleteIssues([]);
                 setFormErrorSource("submit");
-                setFormError(hasIssueWithoutRenderedField(issuePaths, filteredSections) ? result.error : null);
+                setFormError(hasIssueWithoutRenderedField(issuePaths, filteredSections, new Set(Object.keys(formDerivation?.derive ?? {})))
+                    ? result.error
+                    : null);
             }
             // skip: on entity-success-but-extension-failure the extension-error
             // banner is showing — don't notify (the caller navigates away on success
@@ -1291,7 +1322,7 @@ export function RenderEdit(props) {
                     !pageHeaderCompact &&
                     ActionOverflowMenu !== undefined && {
                     actions: (_jsx(ActionOverflowMenu, { label: translate("kumiko.list.row-actions.more"), items: headerMenuItems, testId: "render-edit-header-menu" })),
-                }) })), _jsx(Form, { onSubmit: () => void handleSubmit(), ...(hideSectionTitles !== true &&
+                }) })), _jsx(Form, { onSubmit: () => void handleSubmit(), ...(focusFirstErrorKey > 0 && { focusFirstErrorKey }), ...(hideSectionTitles !== true &&
                     !titleInShell &&
                     !titleInSettingsHeader &&
                     !recordTitleInHeaderRegion && { title: formTitle }), ...(formSubtitle !== undefined &&
@@ -1431,7 +1462,8 @@ export function RenderEdit(props) {
                                         appendixPlacement: fieldAppendixPlacement,
                                     }), ...(fieldDescription !== undefined && {
                                         description: fieldDescription(field.field),
-                                    }), allIssues: snapshot.errors, valueDisplay: valueDisplay, row: snapshot.values, ...(disabled && { fillDisabled: true }), ...((!isCreate || markChangedFields) &&
+                                    }), allIssues: snapshot.errors, valueDisplay: valueDisplay, row: snapshot.values, ...(disabled && { fillDisabled: true }), ...(hideSectionTitles !== true &&
+                                        section.title !== undefined && { sectionTitle: section.title }), ...((!isCreate || markChangedFields) &&
                                         field.field in snapshot.changes && { changed: true }) }, field.field))) }, gridKey));
                             // Tabs mode: the tab panel is the surface, so field sections render
                             // as unframed padded panels; group cards inside stay framed.

package/dist/components/render-field.d.ts

@@ -42,6 +42,8 @@ export type RenderFieldProps = {
     /** The surrounding form is locked as a whole: the fill button stays visible
      *  but inert, unlike a single readOnly field whose fill button keeps working. */
     readonly fillDisabled?: boolean;
+    /** Label stays for screen readers only (sr-only). */
+    readonly hideLabel?: boolean;
 };
 export declare const AllFieldsRequiredProvider: import("react").Provider<boolean>;
-export declare function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, layout, accent, fillDisabled, }: RenderFieldProps): ReactNode;
+export declare function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay, row, changed, layout, accent, fillDisabled, hideLabel, }: RenderFieldProps): ReactNode;

package/dist/components/render-field.js

@@ -1,5 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { isFormatSpec, SYSTEM_REFERENCE_LABELS, } from "@cosmicdrift/kumiko-framework/ui-types";
+import { isFormatSpec, SYSTEM_REFERENCE_LABELS, UNRESOLVED_REFERENCE_LABEL_KEYS, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { createContext, Fragment, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { useAppFeatures } from "../app/app-features-context.js";
@@ -11,6 +11,7 @@ import { evalRowExtractor } from "../app/row-actions.js";
 import { screenAccessAllows } from "../app/screen-access.js";
 import { useOptionalDispatcher } from "../context/dispatcher-context.js";
 import { useUserRoles } from "../context/user-roles-context.js";
+import { fileIdsOf } from "../file-ids-of.js";
 import { applyFormatSpec, currencyDecimals, EMPTY_VALUE_PLACEHOLDER, } from "../headless/index.js";
 import { REFERENCE_COMBOBOX_LIMIT } from "../hooks/reference-limits.js";
 import { useQuery } from "../hooks/use-query.js";
@@ -25,7 +26,7 @@ import { QueryOptionsSelect } from "./query-options-select.js";
 import { ReferenceCreateDialog } from "./reference-create-dialog.js";
 const AllFieldsRequiredContext = createContext(false);
 export const AllFieldsRequiredProvider = AllFieldsRequiredContext.Provider;
-export function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay = "form", row, changed, layout, accent, fillDisabled, }) {
+export function RenderField({ field, issues, onChange, featureName, labelAppendix, fieldAppendix, appendixPlacement, description, status, allIssues, valueDisplay = "form", row, changed, layout, accent, fillDisabled, hideLabel, }) {
     const { Field, Input, Banner, Text, JsonView } = usePrimitives();
     // App-Locale (i18n) für money/date-Inputs — sonst fielen sie auf
     // navigator.language (Browser-Sprache) zurück statt der gewählten
@@ -48,6 +49,11 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
     // Reference-Field rendert eine eigene Component — sie nutzt
     // useQuery() für den Live-Lookup, also muss sie als React-
     // Komponente gemountet werden (nicht als pure render-Call).
+    // The list input prints its own list-level issues (empty state included), so
+    // the Field wrapper must not print them a second time.
+    const listPrintsOwnIssues = field.type === "embedded" &&
+        field.embeddedListCells !== undefined &&
+        !(field.readOnly && field.renderer !== undefined);
     const control = field.readOnly && field.renderer !== undefined ? (_jsx(FieldRendererOutput, { field: field, renderer: field.renderer, appLocale: appLocale, ...(row !== undefined && { row }) })) : field.type === "embedded" && field.embeddedListCells !== undefined ? (_jsx(EmbeddedListField, { field: field, id: id, onChange: onChange, allIssues: allIssues ?? {}, featureName: featureName ?? "" })) : field.type === "reference" ? (readOnlyText ? (_jsx(ReadOnlyReferenceValue, { field: field, featureName: featureName ?? "" })) : (_jsx(ReferenceInput, { field: field, id: id, hasError: hasError, onChange: onChange, Input: Input, featureName: featureName ?? "" }))) : field.type === "select" && field.selectOptionsQuery !== undefined && !readOnlyText ? (_jsx(QueryOptionsSelect, { field: field, query: field.selectOptionsQuery.query, payload: field.selectOptionsQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : field.type === "select" &&
         field.selectOptionsAvailabilityQuery !== undefined &&
         !readOnlyText ? (_jsx(AvailabilityOptionsSelect, { field: field, query: field.selectOptionsAvailabilityQuery.query, payload: field.selectOptionsAvailabilityQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) && !isFileFieldType(field.type) ? (_jsx(Text, { testId: `field-value-${field.field}`, children: readOnlyDisplayText(field, appLocale, t) })) : field.type === "text" && field.writeOnly === true && !readOnlyText ? (_jsx(WriteOnlyTextInput, { field: field, id: id, hasError: hasError, onChange: onChange, changed: changed === true })) : field.fillAction !== undefined ? (_jsx(FillActionControl, { field: field, fillAction: field.fillAction, row: row ?? { [field.field]: field.value }, onChange: onChange, disabled: fillDisabled === true, Banner: Banner, renderControl: (fill) => renderInput({
@@ -76,7 +82,7 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
         t,
         row,
     }));
-    return (_jsx(Field, { id: id, label: field.label, required: field.required && field.type !== "boolean" && !allFieldsRequired, ...(issues !== undefined && { issues }), ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), testId: `field-${field.field}`, children: control }));
+    return (_jsx(Field, { id: id, label: field.label, required: field.required && field.type !== "boolean" && !allFieldsRequired, ...(issues !== undefined && !listPrintsOwnIssues && { issues }), ...(labelAppendix !== undefined && { labelAppendix }), ...(fieldAppendix !== undefined && { fieldAppendix }), ...(appendixPlacement !== undefined && { appendixPlacement }), ...(description !== undefined && { description }), ...(status !== undefined && { status }), ...(changed === true && { changed }), ...(layout !== undefined && { layout }), ...(accent === true && { accent }), ...(hideLabel === true && { hideLabel }), testId: `field-${field.field}`, children: control }));
 }
 const NUMERIC_FIELD_TYPES = new Set(["number", "bigInt", "decimal"]);
 // A text field takes a number as its string form; a numeric field takes only a
@@ -280,7 +286,7 @@ function inputId(field) {
 // Doesn't resolve the `string` (cross-feature QN) FieldRenderer variant — the
 // list-column path (DataTableCell) doesn't either, so this stays in parity.
 function FieldRendererOutput({ field, renderer, row, appLocale, }) {
-    const { Text, JsonView } = usePrimitives();
+    const { Text, JsonView, FileValueList } = usePrimitives();
     const t = useTranslation();
     const componentName = !isFormatSpec(renderer) && typeof renderer === "object" && renderer !== null
         ? extensionSectionName(renderer)
@@ -293,6 +299,12 @@ function FieldRendererOutput({ field, renderer, row, appLocale, }) {
         if (renderer.format === "json" && JsonView !== undefined) {
             return (_jsx(JsonView, { value: field.value, indent: renderer.indent, testId: `field-value-${field.field}` }));
         }
+        if (renderer.format === "file" && FileValueList !== undefined) {
+            const fileIds = fileIdsOf(field.value);
+            if (fileIds.length === 0)
+                return _jsx(Text, { testId: `field-value-${field.field}`, children: EMPTY_VALUE_PLACEHOLDER });
+            return _jsx(FileValueList, { fileIds: fileIds, testId: `field-value-${field.field}` });
+        }
         // App locale as default when the FormatSpec declares none of its own —
         // otherwise locale-sensitive formats (timestamp/date/number/decimal/
         // bigInt/unit) fell back to Intl's runtime default instead of the app
@@ -340,12 +352,17 @@ function ReadOnlyReferenceValue({ field, featureName, }) {
     // instead of the raw id.
     const systemLabel = SYSTEM_REFERENCE_LABELS[`${refFeature}:${refEntity}`];
     const parts = ids.map((id) => {
-        if (systemLabel !== undefined && id === systemLabel.id) {
+        if (systemLabel !== undefined && (id === systemLabel.id || systemLabel.aliases?.includes(id))) {
             return { id, label: t(systemLabel.labelKey), link: undefined };
         }
         const row = rows.find((r) => String(r["id"] ?? "") === id);
-        if (row === undefined)
-            return { id, label: id, link: undefined };
+        if (row === undefined) {
+            const unknownKey = UNRESOLVED_REFERENCE_LABEL_KEYS[`${refFeature}:${refEntity}`];
+            const label = unknownKey !== undefined && !queryResult.loading && queryResult.error === null
+                ? t(unknownKey)
+                : id;
+            return { id, label, link: undefined };
+        }
         return { id, label: String(row[labelKey] ?? id), link: resolveReferenceLink(refEntity, id) };
     });
     return (_jsx(Text, { testId: `field-value-${field.field}`, children: parts.map(({ id, label, link }, index) => (_jsxs(Fragment, { children: [index > 0 && ", ", link === undefined ? (label) : (_jsx(Link, { href: link.href, onPress: link.onPress, testId: `field-link-${field.field}-${id}`, children: label }))] }, id))) }));
@@ -471,7 +488,9 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
         case "image": {
             const kind = field.type === "image" ? "image" : "file";
             const fileId = typeof field.value === "string" && field.value !== "" ? field.value : null;
-            return (_jsx(Input, { kind: kind, ...common, value: fileId, onChange: (v) => onChange(v), ...(field.accept !== undefined && { accept: field.accept }), ...(field.maxSize !== undefined && { maxSize: field.maxSize }), ...(field.entityType !== undefined && { entityType: field.entityType }), ...(field.entityId !== undefined && { entityId: field.entityId }), ...(field.fieldName !== undefined && { fieldName: field.fieldName }), ...(field.imageVariant !== undefined && { imageVariant: field.imageVariant }), ...(field.capture !== undefined && { capture: field.capture }) }));
+            return (_jsx(Input, { kind: kind, ...common, value: fileId, onChange: (v) => onChange(v), ...(field.accept !== undefined && { accept: field.accept }), ...(field.maxSize !== undefined && { maxSize: field.maxSize }), ...(field.entityType !== undefined && { entityType: field.entityType }), ...(field.uploadActionForm !== undefined && {
+                    uploadActionForm: field.uploadActionForm,
+                }), ...(field.entityId !== undefined && { entityId: field.entityId }), ...(field.fieldName !== undefined && { fieldName: field.fieldName }), ...(field.imageVariant !== undefined && { imageVariant: field.imageVariant }), ...(field.capture !== undefined && { capture: field.capture }) }));
         }
         case "files":
         case "images":

package/dist/components/render-list.d.ts

@@ -1,4 +1,4 @@
-import type { EntityDefinition, EntityListScreenDefinition, IconKey } from "@cosmicdrift/kumiko-framework/ui-types";
+import { type EntityDefinition, type EntityListScreenDefinition, type IconKey } from "@cosmicdrift/kumiko-framework/ui-types";
 import { type ReactNode } from "react";
 import type { ListRowViewModel, Translate } from "../headless/index.ts";
 import type { ListSort } from "../hooks/use-list-url-state.ts";
@@ -34,6 +34,8 @@ export type RenderListProps = {
     readonly emptyContent?: ListEmptyStateContent;
     /** Search or filters changed the result; the empty box then says "no matches". */
     readonly narrowed?: boolean;
+    /** Nothing was narrowed by the user, but a default filter is still on; the empty box then offers "show all" instead of "create the first one". */
+    readonly defaultFilterActive?: boolean;
     /** Plural-forms key for the footer count noun; default is the entity's `:noun` convention key. */
     readonly itemNounKey?: string;
     /** Aktueller Search-Term (vom URL-State / Parent). RenderList puffert

package/dist/components/render-list.js

@@ -1,4 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { UNRESOLVED_REFERENCE_LABEL_KEYS, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { extensionSectionName, useExtensionSectionComponent } from "../app/extension-sections.js";
 import { useReferenceLinkResolver } from "../app/reference-link.js";
@@ -15,7 +16,7 @@ function isHeaderPromotableToolbarAction(action) {
     return action.style === "primary" && !needsActionConfirm(action);
 }
 export function RenderList(props) {
-    const { screen, entity, rows, featureName, translate: translateProp, onRowClick, emptyState, onCreate, createLabel, searchable = false, searchPlaceholder, description, emptyContent, narrowed = false, itemNounKey, searchValue, onSearchChange, sort, onSortChange, pager, onReachEnd, loadingMore, hasMore, rowActions, rowActionMode, rowGrouping, rowTone, toolbarActions, filterFacets, filterValues, onFilterChange, onFilterReset, dateRangeFacets, onDateRangeChange, chromeless, scrollBody, screenPadding, expandedRowIds, onToggleRowExpanded, renderExpandedRow, } = props;
+    const { screen, entity, rows, featureName, translate: translateProp, onRowClick, emptyState, onCreate, createLabel, searchable = false, searchPlaceholder, description, emptyContent, narrowed = false, defaultFilterActive: defaultFilterActiveProp = false, itemNounKey, searchValue, onSearchChange, sort, onSortChange, pager, onReachEnd, loadingMore, hasMore, rowActions, rowActionMode, rowGrouping, rowTone, toolbarActions, filterFacets, filterValues, onFilterChange, onFilterReset, dateRangeFacets, onDateRangeChange, chromeless, scrollBody, screenPadding, expandedRowIds, onToggleRowExpanded, renderExpandedRow, } = props;
     // Wie RenderEdit: Translate-Fallback aus dem i18next-Context, sonst
     // wären Column-Header raw i18n-Keys.
     const t = useTranslation();
@@ -101,6 +102,14 @@ export function RenderList(props) {
             if (col.renderer !== undefined)
                 return col;
             const map = referenceLookups[col.field];
+            const unknownKey = UNRESOLVED_REFERENCE_LABEL_KEYS[`${col.refFeature ?? featureName}:${col.refEntity ?? ""}`];
+            // No raw id for entities that opt in: a placeholder while the lookup
+            // loads, the "unknown" label once it found nothing.
+            const unresolvedLabel = (id) => unknownKey === undefined
+                ? id
+                : map === undefined
+                    ? EMPTY_VALUE_PLACEHOLDER
+                    : translate(unknownKey);
             const labelField = col.refLabelField ?? "id";
             const refEntity = col.refEntity ?? "";
             // Only a row the user can see is linkable: resolved by the server
@@ -126,7 +135,7 @@ export function RenderList(props) {
                 return value.map((v) => {
                     const id = String(v);
                     const target = eagerById.get(id);
-                    const label = String(target?.[labelField] ?? map?.get(id) ?? id);
+                    const label = String(target?.[labelField] ?? map?.get(id) ?? unresolvedLabel(id));
                     // Only a row the user can see is linkable: server eagerload or lookup query.
                     const link = target !== undefined || map?.has(id) === true
                         ? resolveReferenceLink(refEntity, id)
@@ -151,16 +160,23 @@ export function RenderList(props) {
                 if (Array.isArray(value)) {
                     if (value.length === 0)
                         return EMPTY_VALUE_PLACEHOLDER;
-                    return value.map((v) => map?.get(String(v)) ?? String(v)).join(", ");
+                    return value.map((v) => map?.get(String(v)) ?? unresolvedLabel(String(v))).join(", ");
                 }
                 if (value === null || value === undefined || value === "")
                     return EMPTY_VALUE_PLACEHOLDER;
                 const idStr = String(value);
-                return map?.get(idStr) ?? idStr;
+                return map?.get(idStr) ?? unresolvedLabel(idStr);
             };
             return { ...col, renderer, linkFor, linkItemsFor };
         });
-    }, [vm.columns, referenceColumns, referenceLookups, resolveReferenceLink]);
+    }, [
+        vm.columns,
+        referenceColumns,
+        referenceLookups,
+        resolveReferenceLink,
+        featureName,
+        translate,
+    ]);
     const enrichedVm = useMemo(() => ({
         ...vm,
         columns: enrichedColumns,
@@ -205,8 +221,9 @@ export function RenderList(props) {
     // Button. Caller kann via emptyState-Prop komplett überschreiben.
     // Wenn weder onCreate noch ein Override gegeben ist, fällt die
     // DataTable auf den DataTable-Default zurück (`kumiko.list.no-entries`).
+    const defaultFilterActive = defaultFilterActiveProp && onFilterReset !== undefined;
     const composedEmptyState = emptyState ??
-        (onCreate !== undefined || emptyContent !== undefined || narrowed ? (_jsx(ListEmptyStateBody, { content: emptyContent, narrowed: narrowed, translate: translate, createButton: onCreate !== undefined && !narrowed && !createInPageHeader ? (_jsx(Button, { variant: "primary", icon: "plus", onClick: onCreate, testId: "render-list-empty-create", children: effectiveCreateLabel })) : undefined })) : undefined);
+        (onCreate !== undefined || emptyContent !== undefined || narrowed || defaultFilterActive ? (_jsx(ListEmptyStateBody, { content: emptyContent, narrowed: narrowed, defaultFilterActive: defaultFilterActive, ...(onFilterReset !== undefined && { onShowAll: onFilterReset }), translate: translate, createButton: onCreate !== undefined && !narrowed && !defaultFilterActive && !createInPageHeader ? (_jsx(Button, { variant: "primary", icon: "plus", onClick: onCreate, testId: "render-list-empty-create", children: effectiveCreateLabel })) : undefined })) : undefined);
     // Title-Resolution: ein konventioneller i18n-Key `screen:<id>.title`.
     // Wenn das Bundle den Key kennt, schöner Titel; sonst kommt der
     // screenId selber raus (kein "Untitled"-Fallback — der App-Dev sieht
@@ -254,9 +271,13 @@ function ReferenceLookupBridge({ field, refEntity, labelField, featureName, onMa
     // useEffect statt direktem call damit setState außerhalb des Render-
     // Pfads passiert (sonst React-Warning "Cannot update a component
     // while rendering a different component").
+    // Unpublished while loading or after a failed lookup: the renderer treats a missing map as
+    // "not resolved", an empty published map as "nothing found". Only the latter may say "Unknown".
+    const resolved = !lookup.loading && !lookup.failed;
     useEffect(() => {
-        onMap(field, lookup.map);
-    }, [field, lookup.map, onMap]);
+        if (resolved)
+            onMap(field, lookup.map);
+    }, [field, lookup.map, resolved, onMap]);
     return null;
 }
 // ToolbarActionView — pro Toolbar-Action ein Button (+ Confirm-Dialog

package/dist/components/write-form-section.js

@@ -6,6 +6,7 @@ import { dispatcherErrorText } from "../app/write-failed-error.js";
 import { I18N_KEY_PARAM } from "../headless/index.js";
 import { useForm } from "../hooks/use-form.js";
 import { useTranslation } from "../i18n.js";
+import { useUnsavedInputSource } from "../leave-guard.js";
 import { STICKY_PRIMARY_ACTION_PROP, usePrimitives } from "../primitives.js";
 import { GridCellForField } from "./grid-cell-for-field.js";
 import { hasIssueWithoutVisibleField, issuesAfterEdit } from "./render-edit-logic.js";
@@ -44,6 +45,7 @@ export function WriteFormSection({ section, featureName, translate, hideTitle, o
         submit: { type: section.handler, payloadMode: "values" },
         schema,
     });
+    useUnsavedInputSource(() => controller.getSnapshot().isDirty);
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState(null);
     async function handleSubmit() {
@@ -100,7 +102,8 @@ export function WriteFormSection({ section, featureName, translate, hideTitle, o
                         if (remaining !== errors)
                             controller.setErrors(remaining);
                         setError(null);
-                    }, GridCell: GridCell, featureName: featureName, allIssues: snapshot.errors, valueDisplay: "form", row: snapshot.values }, field.field))) }), error !== null && (_jsx(Banner, { variant: "error", testId: "write-form-section-error", children: error })), onFooterAction === undefined && (_jsx(Card, { options: { framed: false, footerBordered: false, footerInset: false }, slots: { footer: submitButton }, testId: "write-form-section-submit-row" }))] }));
+                    }, GridCell: GridCell, featureName: featureName, allIssues: snapshot.errors, valueDisplay: "form", row: snapshot.values, ...(hideTitle !== true &&
+                        section.title !== undefined && { sectionTitle: section.title }) }, field.field))) }), error !== null && (_jsx(Banner, { variant: "error", testId: "write-form-section-error", children: error })), onFooterAction === undefined && (_jsx(Card, { options: { framed: false, footerBordered: false, footerInset: false }, slots: { footer: submitButton }, testId: "write-form-section-submit-row" }))] }));
     // Section always flattens to a borderless divider when rendered inside
     // RenderEdit's own <Form> in tabs mode (hideTitle) — an unframed Card panel
     // stands in, like render-edit.tsx's tabs-mode fields/extension branches.

package/dist/field-issue-text.d.ts

@@ -0,0 +1,4 @@
+import type { FieldIssue } from "./headless/index.ts";
+type TranslateFn = (key: string, params?: Readonly<Record<string, unknown>>) => string;
+export declare function fieldIssueText(t: TranslateFn, issue: FieldIssue): string;
+export {};

package/dist/field-issue-text.js

@@ -0,0 +1,14 @@
+const INVALID_FORMAT_KEY = "errors.validation.invalid_format";
+// Zod reports every string-format failure under one code; the per-format key
+// (…invalid_format.email) carries a worked example, the generic key stays the
+// fallback for formats without one.
+export function fieldIssueText(t, issue) {
+    const format = issue.params?.["format"];
+    if (issue.i18nKey === INVALID_FORMAT_KEY && typeof format === "string") {
+        const formatKey = `${INVALID_FORMAT_KEY}.${format}`;
+        const text = t(formatKey, issue.params);
+        if (text !== formatKey)
+            return text;
+    }
+    return t(issue.i18nKey, issue.params);
+}

package/dist/file-ids-of.d.ts

@@ -0,0 +1 @@
+export declare function fileIdsOf(value: unknown): readonly string[];

package/dist/file-ids-of.js

@@ -0,0 +1,7 @@
+export function fileIdsOf(value) {
+    if (typeof value === "string")
+        return value === "" ? [] : [value];
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((entry) => typeof entry === "string" && entry !== "");
+}

package/dist/flow-diagram/icons.d.ts

@@ -0,0 +1,3 @@
+import type { FlowIcon } from "./types.ts";
+/** Inner markup for a 24x24 viewBox, stroked via the `.icon` CSS class. "ai" renders as a text badge instead — see render.ts. */
+export declare const ICONS: Record<Exclude<FlowIcon, "ai">, string>;

package/dist/flow-diagram/icons.js

@@ -0,0 +1,14 @@
+/** Inner markup for a 24x24 viewBox, stroked via the `.icon` CSS class. "ai" renders as a text badge instead — see render.ts. */
+export const ICONS = {
+    ui: '<rect class="icon" x="3" y="4" width="18" height="15" rx="1.5"/><path class="icon" d="M3 8h18"/>',
+    api: '<path class="icon" d="M8 6l-5 6 5 6"/><path class="icon" d="M16 6l5 6-5 6"/>',
+    handler: '<path class="icon" d="M8 4l-4 8 4 8"/><path class="icon" d="M16 4l4 8-4 8"/><path class="icon" d="M11 20l2-16"/>',
+    "event-store": '<path class="icon" d="M4 6c0-1.5 3.6-2.5 8-2.5S20 4.5 20 6s-3.6 2.5-8 2.5S4 7.5 4 6z"/><path class="icon" d="M4 6v12c0 1.5 3.6 2.5 8 2.5s8-1 8-2.5V6"/><path class="icon" d="M4 12c0 1.5 3.6 2.5 8 2.5s8-1 8-2.5"/>',
+    database: '<path class="icon" d="M4 6c0-1.5 3.6-2.5 8-2.5S20 4.5 20 6s-3.6 2.5-8 2.5S4 7.5 4 6z"/><path class="icon" d="M4 6v12c0 1.5 3.6 2.5 8 2.5s8-1 8-2.5V6"/>',
+    inbox: '<path class="icon" d="M3 6h18v13H3z"/><path class="icon" d="M3 6l9 7 9-7"/>',
+    broadcast: '<path class="icon" d="M12 20v-1"/><path class="icon" d="M8.5 15.5a5 5 0 017 0"/><path class="icon" d="M5 12a9 9 0 0114 0"/>',
+    person: '<circle class="icon" cx="12" cy="8" r="3.2"/><path class="icon" d="M5 20c0-4 3-6 7-6s7 2 7 6"/>',
+    check: '<path class="icon" d="M5 12l5 5L20 6"/>',
+    stop: '<rect class="icon" x="7" y="7" width="10" height="10" rx="1.5"/>',
+    box: '<rect class="icon" x="4" y="4" width="16" height="16" rx="2"/>',
+};

package/dist/flow-diagram/index.d.ts

@@ -0,0 +1,2 @@
+export { renderFlow } from "./render.ts";
+export type { FlowEdge, FlowIcon, FlowNode, FlowNodeKind, FlowSpec } from "./types.ts";