@beechcms/core 0.8.1 → 0.9.0

package/dist/dashboard-layout/content-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-view.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/content-view.ts"],"names":[],"mappings":"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"}

package/dist/dashboard-layout/content-view.js

@@ -0,0 +1,285 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+import { z } from 'zod';
+import { findBranchById } from '../engine/seeds/seed-registry.js';
+import { isSingleChoiceTags, tagOptionValues } from '../engine/seeds/tag-options.js';
+import { isViewAuthorized } from './view-authorization.js';
+import { kanbanViewConfigSchema, kanbanCardConfigSchema, validateCardConfigAgainstSeed, } from './seed-layout.js';
+import { resolveKanbanConfig } from './kanban/kanban.js';
+// ---------------------------------------------------------------------------
+// View types
+// ---------------------------------------------------------------------------
+/** Zod needs a tuple. Kept equal to AUTHORIZABLE_VIEWS by content-view.test.ts. */
+export const VIEW_TYPE_IDS = ['table', 'gallery', 'kanban'];
+// ---------------------------------------------------------------------------
+// Column references — Branch IDs or engine system columns, never aliases
+// ---------------------------------------------------------------------------
+export const VIEW_SYSTEM_COLUMNS = ['slug', 'status', 'created_at', 'updated_at'];
+const BRANCH_REF_RE = /^br_[A-Za-z0-9]+$/;
+export const viewColumnRefSchema = z.union([
+    z.enum(VIEW_SYSTEM_COLUMNS),
+    z.string().regex(BRANCH_REF_RE),
+]);
+// ---------------------------------------------------------------------------
+// Config building blocks
+// ---------------------------------------------------------------------------
+/** Mirrors the dashboard toolbar operator set (apps/dashboard/src/lib/filter-dsl.ts). */
+export const VIEW_FILTER_OPERATORS = [
+    'eq', 'gt', 'gte', 'lt', 'lte', 'contains', 'is_empty', 'is_not_empty',
+];
+/** Mirrors MAX_CONDITIONS_PER_FILTER in the dashboard toolbar. */
+export const MAX_VIEW_CONDITIONS = 3;
+export const viewConditionSchema = z.object({
+    op: z.enum(VIEW_FILTER_OPERATORS),
+    value: z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),
+});
+export const viewFilterSchema = z.object({
+    columnRef: viewColumnRefSchema,
+    conditions: z.array(viewConditionSchema).min(1).max(MAX_VIEW_CONDITIONS),
+});
+export const viewSortSchema = z.object({
+    columnRef: viewColumnRefSchema,
+    desc: z.boolean(),
+});
+export const viewGroupBySchema = z.object({
+    columnRef: viewColumnRefSchema,
+    /** Only meaningful on a date column; stripped otherwise by validateViewConfigAgainstSeed. */
+    datePrecision: z.object({ year: z.boolean(), month: z.boolean(), day: z.boolean() }).optional(),
+});
+export const VIEW_DENSITIES = ['compact', 'normal', 'comfortable'];
+export const viewAppearanceSchema = z.object({
+    density: z.enum(VIEW_DENSITIES).optional(),
+    hiddenColumns: z.array(viewColumnRefSchema).max(200).optional(),
+    /** Display order of data columns; columns missing from the list follow in default order. */
+    columnOrder: z.array(viewColumnRefSchema).max(200).optional(),
+    pageSize: z.number().int().min(1).max(100).optional(),
+});
+export const VIEW_FORMAT_TONES = ['neutral', 'info', 'success', 'warning', 'danger'];
+/**
+ * View-neutral targets: `element` is the whole row (Table) or card (Gallery/Kanban), `field` is
+ * the intersection element × columnRef. The dashboard's legacy `row`/`cell` map 1:1 (Sprint 2).
+ */
+export const VIEW_FORMAT_TARGETS = ['element', 'field'];
+export const VIEW_TEXT_STYLES = ['bold', 'italic', 'underline'];
+export const viewConditionalFormatSchema = z.object({
+    id: z.string().min(1).max(64),
+    enabled: z.boolean(),
+    /** Ascending: 0 wins over 10. */
+    priority: z.number().int().min(0).max(1000),
+    label: z.string().max(60).optional(),
+    columnRef: viewColumnRefSchema,
+    conditions: z.array(viewConditionSchema).min(1).max(MAX_VIEW_CONDITIONS),
+    tone: z.enum(VIEW_FORMAT_TONES),
+    target: z.enum(VIEW_FORMAT_TARGETS),
+    textStyles: z.array(z.enum(VIEW_TEXT_STYLES)).max(3).default([]),
+});
+// ---------------------------------------------------------------------------
+// Gallery folder styles
+// ---------------------------------------------------------------------------
+export const FOLDER_COLORS = ['slate', 'red', 'orange', 'amber', 'green', 'teal', 'blue', 'violet', 'pink'];
+export const FOLDER_ICONS = [
+    'Folder', 'Star', 'Heart', 'Image', 'Camera', 'Calendar', 'Tag', 'Bookmark', 'Home',
+    'Gift', 'Video', 'Music', 'Book', 'Flag', 'Briefcase', 'Users', 'Sun', 'Crown',
+];
+export const MAX_FOLDER_STYLES = 100;
+/** Cosmetic override of one gallery folder. `label` and `description` are display-only: the folder's group value is untouched. */
+export const folderStyleSchema = z.object({
+    color: z.enum(FOLDER_COLORS).optional(),
+    icon: z.enum(FOLDER_ICONS).optional(),
+    label: z.string().trim().max(60).optional(),
+    description: z.string().trim().max(120).optional(),
+});
+function cleanFolders(folders) {
+    const entries = Object.entries(folders)
+        .map(([key, style]) => [key, {
+            ...(style.color ? { color: style.color } : {}),
+            ...(style.icon ? { icon: style.icon } : {}),
+            ...(style.label ? { label: style.label } : {}),
+            ...(style.description ? { description: style.description } : {}),
+        }])
+        .filter(([, style]) => Object.keys(style).length > 0);
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+// ---------------------------------------------------------------------------
+// The config
+// ---------------------------------------------------------------------------
+/**
+ * Persisted per-instance configuration. Every key has a default, so `{}` parses into a complete
+ * config, and a stored row written by an older dashboard reads back fully shaped. Unknown keys
+ * are stripped (zod default), never rejected.
+ */
+export const contentViewConfigSchema = z.object({
+    filters: z.array(viewFilterSchema).max(50).default([]),
+    sort: viewSortSchema.nullable().default(null),
+    groupBy: viewGroupBySchema.nullable().default(null),
+    appearance: viewAppearanceSchema.default({}),
+    conditionalFormats: z.array(viewConditionalFormatSchema).max(50).default([]),
+    /** Kanban-only. Dropped from any non-kanban instance. */
+    kanban: kanbanViewConfigSchema.optional(),
+    /** Card layout (Kanban and Gallery). Dropped from any other instance. */
+    card: kanbanCardConfigSchema.optional(),
+    /** Gallery-only. Style per folder, keyed by the normalized group value. Dropped from any other instance. */
+    folders: z.record(z.string().min(1).max(100), folderStyleSchema)
+        .refine((folders) => Object.keys(folders).length <= MAX_FOLDER_STYLES)
+        .optional(),
+});
+export function emptyViewConfig() {
+    return contentViewConfigSchema.parse({});
+}
+// ---------------------------------------------------------------------------
+// Request bodies
+// ---------------------------------------------------------------------------
+export const VIEW_TITLE_MAX_LENGTH = 60;
+/** Trimmed. Empty or whitespace-only collapses to null, which means "render the translated type label". */
+export const viewTitleSchema = z
+    .string()
+    .trim()
+    .max(VIEW_TITLE_MAX_LENGTH)
+    .nullable()
+    .transform((value) => (value === null || value.length === 0 ? null : value));
+export const createContentViewInputSchema = z.object({
+    type: z.enum(VIEW_TYPE_IDS),
+    title: viewTitleSchema.optional(),
+    config: contentViewConfigSchema.optional(),
+});
+export const updateContentViewInputSchema = z
+    .object({
+    title: viewTitleSchema.optional(),
+    /** Whole-config replacement, not a deep merge. */
+    config: contentViewConfigSchema.optional(),
+})
+    .refine((body) => body.title !== undefined || body.config !== undefined, {
+    message: 'Provide at least one of title, config',
+});
+export const reorderContentViewsInputSchema = z.object({
+    ids: z.array(z.string().min(1).max(64)).min(1).max(200),
+});
+// ---------------------------------------------------------------------------
+// Cleanup against the live seed
+// ---------------------------------------------------------------------------
+const SYSTEM_COLUMN_SET = new Set(VIEW_SYSTEM_COLUMNS);
+const DATE_SYSTEM_COLUMNS = new Set(['created_at', 'updated_at']);
+function refExists(seed, ref) {
+    return SYSTEM_COLUMN_SET.has(ref) || findBranchById(seed, ref) !== null;
+}
+function isDateRef(seed, ref) {
+    return DATE_SYSTEM_COLUMNS.has(ref) || findBranchById(seed, ref)?.type === 'date';
+}
+/** True when `ref` addresses a `tags` branch that is multiple choice, which cannot be sorted or grouped. */
+function isMultipleChoiceTagsRef(seed, ref) {
+    const branch = findBranchById(seed, ref);
+    return branch?.type === 'tags' && !isSingleChoiceTags(branch);
+}
+/**
+ * Brief §2.10: `sort`, `groupBy` and `kanban.sort` may reference a `tags` branch only when it is single choice;
+ * `kanban.axisBranchId` may reference a `tags` branch only when it is a kanban axis candidate.
+ * One message per offending reference, in the order sort, groupBy, kanban axis, kanban sort; `[]` when valid.
+ * References to missing branches and to non-`tags` branches are not issues (cleanup handles them). Pure.
+ */
+export function viewConfigChoiceIssues(config, seed) {
+    const issues = [];
+    const multipleChoiceIssue = (ref, usage) => {
+        if (!isMultipleChoiceTagsRef(seed, ref))
+            return;
+        const alias = findBranchById(seed, ref)?.alias;
+        issues.push(`'${alias}' is a multiple-choice tags field: ${usage} needs multiple: false.`);
+    };
+    if (config.sort)
+        multipleChoiceIssue(config.sort.columnRef, 'sort');
+    if (config.groupBy)
+        multipleChoiceIssue(config.groupBy.columnRef, 'group by');
+    const axis = config.kanban?.axisBranchId ? findBranchById(seed, config.kanban.axisBranchId) : null;
+    if (axis?.type === 'tags' && !(isSingleChoiceTags(axis) && tagOptionValues(axis).length > 0)) {
+        issues.push(`'${axis.alias}' cannot be a kanban axis: it needs a single-choice tags field with options.`);
+    }
+    if (config.kanban?.sort)
+        multipleChoiceIssue(config.kanban.sort.branchId, 'kanban card sort');
+    return issues;
+}
+function cleanKanban(kanban, seed) {
+    const { candidates } = resolveKanbanConfig(seed);
+    const axisOk = kanban.axisBranchId !== null && candidates.some((c) => c.branchId === kanban.axisBranchId);
+    const sortOk = kanban.sort !== null && findBranchById(seed, kanban.sort.branchId) !== null
+        && !isMultipleChoiceTagsRef(seed, kanban.sort.branchId);
+    return {
+        ...kanban,
+        axisBranchId: axisOk ? kanban.axisBranchId : null,
+        sort: sortOk ? kanban.sort : null,
+    };
+}
+/**
+ * Pure auto-cleanup, never an error: drops references to branches the seed no longer has,
+ * `sort`/`groupBy`/kanban sort on a multiple-choice `tags` branch,
+ * duplicate filters on one column, date precision on a non-date grouping, and the Kanban
+ * sub-config on a non-kanban instance and the card layout on a table instance. Same policy as validateCardConfigAgainstSeed.
+ */
+export function validateViewConfigAgainstSeed(config, seed, type) {
+    const seenFilterRefs = new Set();
+    const filters = config.filters.filter((filter) => {
+        if (!refExists(seed, filter.columnRef) || seenFilterRefs.has(filter.columnRef))
+            return false;
+        seenFilterRefs.add(filter.columnRef);
+        return true;
+    });
+    const sort = config.sort && refExists(seed, config.sort.columnRef) && !isMultipleChoiceTagsRef(seed, config.sort.columnRef)
+        ? config.sort
+        : null;
+    let groupBy = config.groupBy
+        && refExists(seed, config.groupBy.columnRef)
+        && !isMultipleChoiceTagsRef(seed, config.groupBy.columnRef)
+        ? config.groupBy
+        : null;
+    if (groupBy?.datePrecision && !isDateRef(seed, groupBy.columnRef)) {
+        groupBy = { columnRef: groupBy.columnRef };
+    }
+    const appearance = { ...config.appearance };
+    if (appearance.hiddenColumns) {
+        appearance.hiddenColumns = [...new Set(appearance.hiddenColumns)].filter((ref) => refExists(seed, ref));
+    }
+    if (appearance.columnOrder) {
+        appearance.columnOrder = [...new Set(appearance.columnOrder)].filter((ref) => refExists(seed, ref));
+    }
+    const conditionalFormats = config.conditionalFormats.filter((rule) => refExists(seed, rule.columnRef));
+    const cleaned = { filters, sort, groupBy, appearance, conditionalFormats };
+    if (type === 'kanban' && config.kanban)
+        cleaned.kanban = cleanKanban(config.kanban, seed);
+    if ((type === 'kanban' || type === 'gallery') && config.card) {
+        cleaned.card = validateCardConfigAgainstSeed(config.card, seed, { mediaImageOnly: type === 'gallery' }).cleaned;
+    }
+    if (type === 'gallery' && config.folders) {
+        const folders = cleanFolders(config.folders);
+        if (folders)
+            cleaned.folders = folders;
+    }
+    return cleaned;
+}
+// ---------------------------------------------------------------------------
+// Projection (storage → API)
+// ---------------------------------------------------------------------------
+/** null when the seed's allow-list does not authorize the record's type (hidden, never deleted). */
+export function projectContentView(record, seed) {
+    const type = record.type;
+    if (!isViewAuthorized(seed, type))
+        return null;
+    return { ...record, type, config: validateViewConfigAgainstSeed(record.config, seed, type) };
+}
+/** Order-preserving. The caller passes records already sorted by position. */
+export function projectContentViews(records, seed) {
+    const views = [];
+    for (const record of records) {
+        const view = projectContentView(record, seed);
+        if (view)
+            views.push(view);
+    }
+    return views;
+}
+/**
+ * The full position order of a seed's rows after its visible views were reordered. Hidden rows
+ * (types the allow-list currently rejects) keep their slot; visible slots are refilled in the
+ * requested order. Writing the result compacts positions to 0..n-1 with no duplicates.
+ */
+export function mergeContentViewOrder(allIds, visibleOrder) {
+    const visible = new Set(visibleOrder);
+    const queue = [...visibleOrder];
+    return allIds.map((id) => (visible.has(id) ? queue.shift() : id));
+}

package/dist/dashboard-layout/content-view.repository.d.ts

@@ -0,0 +1,39 @@
+import type { DashboardView } from './view-authorization.js';
+import type { ContentViewConfig, ContentViewRecord } from './content-view.js';
+export interface NewContentView {
+    seedSlug: string;
+    type: DashboardView;
+    title: string | null;
+    /** Already cleaned by validateViewConfigAgainstSeed. */
+    config: ContentViewConfig;
+}
+export interface ContentViewPatch {
+    /** undefined → keep; null → reset to the translated type label. */
+    title?: string | null;
+    /** undefined → keep; otherwise replaces the whole config. */
+    config?: ContentViewConfig;
+}
+export type RemoveContentViewResult = 'deleted' | 'not-found' | 'last-table';
+/**
+ * Persistence for shared, ordered view instances (`seed_views`). Every write is one statement
+ * or one D1 batch, so each method is atomic. Implementations own id minting and timestamps
+ * (IIdGenerator / IClock injected).
+ */
+export interface IContentViewRepository {
+    /** All rows of a seed, including types the allow-list currently hides, ordered by position. */
+    listBySeed(seedSlug: string): Promise<ContentViewRecord[]>;
+    get(seedSlug: string, id: string): Promise<ContentViewRecord | null>;
+    /**
+     * Inserts one untitled instance per type, at positions 0..n-1. Each insert is skipped when the
+     * seed already has an instance of that type, so concurrent first reads never duplicate.
+     */
+    ensureDefaults(seedSlug: string, types: readonly DashboardView[], updatedBy: string): Promise<void>;
+    /** Appends after the current last position. */
+    create(input: NewContentView, updatedBy: string): Promise<ContentViewRecord>;
+    update(seedSlug: string, id: string, patch: ContentViewPatch, updatedBy: string): Promise<ContentViewRecord | null>;
+    /** Refuses ('last-table') to delete the seed's only Table instance, atomically. */
+    remove(seedSlug: string, id: string): Promise<RemoveContentViewResult>;
+    /** Writes position = index for each id. Ids not listed keep their position. */
+    reorder(seedSlug: string, orderedIds: readonly string[], updatedBy: string): Promise<void>;
+}
+//# sourceMappingURL=content-view.repository.d.ts.map

package/dist/dashboard-layout/content-view.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-view.repository.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/content-view.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAA;AAE5E;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAC1D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACpE;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnG,+CAA+C;IAC/C,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACnH,mFAAmF;IACnF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACtE,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3F"}

package/dist/dashboard-layout/content-view.repository.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+export {};

package/dist/dashboard-layout/dashboard-layout.d.ts

@@ -44,6 +44,11 @@ export declare const WIDGET_TYPE_REGEX: RegExp;
 /** Max serialized size of a single widget `config`
  *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
 export declare const MAX_WIDGET_CONFIG_BYTES = 8192;
+/** Max serialized size of a whole layout. Keeps the `dashboard_layouts` row
+ *  far below D1's per-row limit and bounds the per-request cost of every GET. */
+export declare const MAX_DASHBOARD_LAYOUT_BYTES: number;
+export declare const MAX_SECTIONS_PER_PAGE = 50;
+export declare const MAX_WIDGETS_PER_COLUMN = 50;
 export declare const dashboardWidgetInstanceSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodString;

package/dist/dashboard-layout/dashboard-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-layout.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/dashboard-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAM9C;;sEAEsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,uBAAuB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B;gCAC4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAMD;sEACsE;AACtE,eAAO,MAAM,iBAAiB,QAA6B,CAAA;AAE3D;sEACsE;AACtE,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAM3C,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;iBAGhC,CAAA;AACF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAOjC,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAA;AAQF;;6DAE6D;AAC7D,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAC7B,eAAe,CA2EjB;AAMD,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9B;uEACmE;IACnE,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;;mDAImD;AACnD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,sBAAsB,GAC1B,6BAA6B,CA2E/B"}
+{"version":3,"file":"dashboard-layout.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/dashboard-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAM9C;;sEAEsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,uBAAuB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B;gCAC4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAMD;sEACsE;AACtE,eAAO,MAAM,iBAAiB,QAA6B,CAAA;AAE3D;sEACsE;AACtE,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAE3C;iFACiF;AACjF,eAAO,MAAM,0BAA0B,QAAa,CAAA;AAEpD,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAOxC,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;iBAGhC,CAAA;AACF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAOjC,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAQ/B,CAAA;AAQH;;6DAE6D;AAC7D,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAC7B,eAAe,CA2EjB;AAMD,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9B;uEACmE;IACnE,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;;mDAImD;AACnD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,sBAAsB,GAC1B,6BAA6B,CA2E/B"}

package/dist/dashboard-layout/dashboard-layout.js

@@ -10,21 +10,27 @@ export const WIDGET_TYPE_REGEX = /^[a-z0-9@][a-z0-9@/_-]*$/;
 /** Max serialized size of a single widget `config`
  *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
 export const MAX_WIDGET_CONFIG_BYTES = 8192;
+/** Max serialized size of a whole layout. Keeps the `dashboard_layouts` row
+ *  far below D1's per-row limit and bounds the per-request cost of every GET. */
+export const MAX_DASHBOARD_LAYOUT_BYTES = 256 * 1024;
+export const MAX_SECTIONS_PER_PAGE = 50;
+export const MAX_WIDGETS_PER_COLUMN = 50;
+const ID_MAX = 64;
 // ---------------------------------------------------------------------------
 // Zod schemas for shape validation
 // ---------------------------------------------------------------------------
 export const dashboardWidgetInstanceSchema = z.object({
-    id: z.string().min(1),
+    id: z.string().min(1).max(ID_MAX),
     type: z.string().regex(WIDGET_TYPE_REGEX),
     title: z.string().max(80).optional(),
     config: z.record(z.string(), z.unknown()),
 });
 export const dashboardColumnSchema = z.object({
-    id: z.string().min(1),
-    widgets: z.array(dashboardWidgetInstanceSchema),
+    id: z.string().min(1).max(ID_MAX),
+    widgets: z.array(dashboardWidgetInstanceSchema).max(MAX_WIDGETS_PER_COLUMN),
 });
 export const dashboardSectionSchema = z.object({
-    id: z.string().min(1),
+    id: z.string().min(1).max(ID_MAX),
     label: z.string().max(60).optional(),
     hideLabel: z.boolean().optional(),
     collapsible: z.boolean().optional(),
@@ -32,16 +38,18 @@ export const dashboardSectionSchema = z.object({
     columnSpans: z.array(z.number().int().min(1).max(12)).optional(),
 });
 export const dashboardPageSchema = z.object({
-    id: z.string().min(1),
+    id: z.string().min(1).max(ID_MAX),
     slug: z.string().regex(/^[a-z0-9][a-z0-9-]*$/).max(40),
     label: z.string().min(1).max(60),
     icon: z.string().max(40).optional(),
-    sections: z.array(dashboardSectionSchema).min(1),
+    sections: z.array(dashboardSectionSchema).min(1).max(MAX_SECTIONS_PER_PAGE),
 });
-export const dashboardLayoutSchema = z.object({
+export const dashboardLayoutSchema = z
+    .object({
     version: z.literal(1),
     pages: z.array(dashboardPageSchema).min(1).max(8),
-});
+})
+    .refine((layout) => new TextEncoder().encode(JSON.stringify(layout)).length <= MAX_DASHBOARD_LAYOUT_BYTES, { message: `Layout exceeds the ${MAX_DASHBOARD_LAYOUT_BYTES / 1024} KB size limit.` });
 // ---------------------------------------------------------------------------
 // Default dashboard layout generator
 // ---------------------------------------------------------------------------
@@ -130,7 +138,7 @@ export function validateDashboardLayout(layout, ctx) {
                 ...col,
                 widgets: (col.widgets ?? []).filter((w) => {
                     const seedSlug = (w.config ?? {})['seedSlug'];
-                    if (typeof seedSlug === 'string' && !ctx.seedSlugs.has(seedSlug)) {
+                    if (typeof seedSlug === 'string' && seedSlug !== '' && !ctx.seedSlugs.has(seedSlug)) {
                         warnings.push(`Widget '${w.type}' (id=${w.id}) removed: seed '${seedSlug}' is not registered.`);
                         return false;
                     }

package/dist/dashboard-layout/kanban/kanban.d.ts

@@ -1,6 +1,6 @@
 import type { Seed, Branch, FilterGroup } from '../../engine/types.js';
 /** Branch types that can form a discrete, finite set of columns (KB §2). */
-export type KanbanAxisBranchType = 'text' | 'tags' | 'boolean';
+export type KanbanAxisBranchType = 'tags' | 'boolean';
 /** A branch eligible to be the kanban axis. */
 export interface KanbanAxisCandidate {
     /** Stable branch id (br_XX) — persisted as the axis key. Never the alias. */
@@ -14,9 +14,17 @@ export interface KanbanColumnDescriptor {
     /** The discrete axis value. `null` ⇒ the always-last "Senza valore" column. */
     value: string | null;
     label: string;
+    /** The option color (#RRGGBB) of a tags-axis column. Absent on boolean columns and on the null column. */
+    color?: string;
+    /**
+     * True on the null column of a required axis. No valid entry belongs there: it only collects entries
+     * whose value is missing or no longer an option, so none disappears from the board. The board shows it
+     * only while it holds entries and never moves or creates an entry into it.
+     */
+    fallback?: true;
 }
 /** Per-seed, dashboard-side kanban view preferences. Persisted in
- *  seed_layouts.view_config (KB-S02). NOT part of FormLayout. */
+ *  seed_views.config.kanban (one per Kanban view instance). NOT part of FormLayout. */
 export interface KanbanConfig {
     /** Chosen axis branch id, or null when the user has not configured one (KB-U02). */
     axisBranchId: string | null;
@@ -41,19 +49,16 @@ export interface KanbanCompatibility {
  * Q3: seeds with `allowDrafts: true` are NOT kanban-compatible.
  */
 export declare function resolveKanbanConfig(seed: Seed): KanbanCompatibility;
+/** True when every entry must hold an axis value, so moving a card to the null column is never valid. */
+export declare function isKanbanAxisRequired(branch: Pick<Branch, 'requiredOnCreate' | 'requiredOnUpdate'>): boolean;
 /**
  * Deterministic, stable column order for a chosen axis (Q2). The "Senza valore"
- * (value: null) column is always appended last. Values out of `options` are NOT
- * given their own column (KB-U25) — the board folds them into "Senza valore".
- *
- * @param distinctTagValues unique tag values observed in data (tags axis without options).
- */
-export declare function resolveKanbanColumns(branch: Branch, distinctTagValues?: string[]): KanbanColumnDescriptor[];
-/**
- * Pure: the FilterGroup selecting one kanban column's entries for a given axis branch.
- * `value: null` ⇒ "Senza valore" — entries where the axis field is NULL or empty (KB-U25).
- * Boolean descriptor values 'true'/'false' are coerced to actual booleans for the engine.
+ * (value: null) column is always appended last; on a required axis it is a `fallback` column.
+ * Values out of `options` are NOT given their own column (KB-U25): {@link kanbanColumnFilter}
+ * folds them into "Senza valore".
+ * A tags axis yields one column per option, in declared order, carrying the option color.
  */
+export declare function resolveKanbanColumns(branch: Branch): KanbanColumnDescriptor[];
 /** Body of PATCH /:slug/:id/kanban-move. The server applies the axis change (if any)
  *  AND the position upsert atomically (KB-S04e). */
 export interface KanbanMoveBody {
@@ -61,15 +66,24 @@ export interface KanbanMoveBody {
     axisBranchId: string;
     /** New fractional-index key for this entry in the destination column (KB-S04b/d). */
     position: string;
-    /** Present only on a cross-column move (axis value changed). Omit for same-column reorder. */
+    /** Present only on a cross-column move: the destination column value (`null` = "Senza valore"). */
     axis?: {
-        kind: 'scalar';
         value: string | null;
-    } | {
-        kind: 'tags';
-        oldValue: string | null;
-        newValue: string | null;
     };
 }
+/**
+ * The entry value that puts an entry in the kanban column `columnValue` of `branch`:
+ * boolean → `true`/`false` (`null` column → `null`), tags → `[columnValue]` (`null` column → `[]`),
+ * any other type → `columnValue` unchanged. Pure.
+ */
+export declare function kanbanColumnEntryValue(branch: Branch, columnValue: string | null): boolean | string | string[] | null;
+/**
+ * Pure: the FilterGroup selecting one kanban column's entries for a given axis branch.
+ * `value: null` ⇒ "Senza valore" — entries where the axis field is NULL or empty (KB-U25).
+ * On a tags axis with options it also holds entries whose stored value is no longer an option
+ * (removed or renamed in the seed): `not_in` the option values matches both, so no entry
+ * falls outside every column.
+ * Boolean descriptor values 'true'/'false' are coerced to actual booleans for the engine.
+ */
 export declare function kanbanColumnFilter(branch: Branch, value: string | null): FilterGroup;
 //# sourceMappingURL=kanban.d.ts.map

package/dist/dashboard-layout/kanban/kanban.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kanban.d.ts","sourceRoot":"","sources":["../../../src/dashboard-layout/kanban/kanban.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEtE,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AAE9D,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,oBAAoB,CAAA;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;iEACiE;AACjE,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,oFAAoF;IACpF,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACtD,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CAAA;AAE/E,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,wBAAwB,CAAA;IACjC,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAClC;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,mBAAmB,CAanE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,iBAAiB,GAAE,MAAM,EAAO,GAC/B,sBAAsB,EAAE,CAiB1B;AAED;;;;GAIG;AACH;oDACoD;AACpD,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAA;IAChB,8FAA8F;IAC9F,IAAI,CAAC,EACD;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CACvE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAYpF"}
+{"version":3,"file":"kanban.d.ts","sourceRoot":"","sources":["../../../src/dashboard-layout/kanban/kanban.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAItE,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAA;AAErD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,oBAAoB,CAAA;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAA;CAChB;AAED;uFACuF;AACvF,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,oFAAoF;IACpF,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACtD,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CAAA;AAE/E,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,wBAAwB,CAAA;IACjC,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAClC;AAkBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,mBAAmB,CAanE;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,GAAG,OAAO,CAE3G;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAY7E;AAED;oDACoD;AACpD,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAA;IAChB,mGAAmG;IACnG,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAIpC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAgBpF"}

package/dist/dashboard-layout/kanban/kanban.js

@@ -1,5 +1,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2024–2026 Flavio De Musso
+import { isLocalizedBranch } from '../../engine/localization/localization.js';
+import { isSingleChoiceTags, tagOptionValues } from '../../engine/seeds/tag-options.js';
 /** Branch types that are explicitly never an axis (KB §2). */
 const NON_AXIS_TYPES = new Set([
     'richtext', 'file', 'number', 'date', 'json', 'relation', 'repeater',
@@ -7,12 +9,14 @@ const NON_AXIS_TYPES = new Set([
 function isAxisCandidate(b) {
     if (b.alias === 'status')
         return null; // system status excluded (KB §2)
+    // A localized value is a locale dictionary, not one discrete column value, and a card move would
+    // overwrite every translation with the column value.
+    if (isLocalizedBranch(b))
+        return null;
     if (NON_AXIS_TYPES.has(b.type))
         return null;
-    if (b.type === 'text')
-        return (b.options && b.options.length > 0) ? 'text' : null;
     if (b.type === 'tags')
-        return 'tags';
+        return isSingleChoiceTags(b) && tagOptionValues(b).length > 0 ? 'tags' : null;
     if (b.type === 'boolean')
         return 'boolean';
     return null;
@@ -38,37 +42,57 @@ export function resolveKanbanConfig(seed) {
     }
     return { compatible: true, candidates };
 }
+/** True when every entry must hold an axis value, so moving a card to the null column is never valid. */
+export function isKanbanAxisRequired(branch) {
+    return Boolean(branch.requiredOnCreate || branch.requiredOnUpdate);
+}
 /**
  * Deterministic, stable column order for a chosen axis (Q2). The "Senza valore"
- * (value: null) column is always appended last. Values out of `options` are NOT
- * given their own column (KB-U25) — the board folds them into "Senza valore".
- *
- * @param distinctTagValues unique tag values observed in data (tags axis without options).
+ * (value: null) column is always appended last; on a required axis it is a `fallback` column.
+ * Values out of `options` are NOT given their own column (KB-U25): {@link kanbanColumnFilter}
+ * folds them into "Senza valore".
+ * A tags axis yields one column per option, in declared order, carrying the option color.
  */
-export function resolveKanbanColumns(branch, distinctTagValues = []) {
+export function resolveKanbanColumns(branch) {
     const cols = [];
     if (branch.type === 'boolean') {
         cols.push({ value: 'false', label: 'No' }, { value: 'true', label: 'Sì' }); // [false, true]
     }
-    else if (branch.type === 'text' && branch.options?.length) {
-        for (const o of branch.options)
-            cols.push({ value: o, label: o }); // options order
-    }
     else if (branch.type === 'tags') {
-        const ordered = branch.options?.length
-            ? branch.options
-            : [...distinctTagValues].sort((a, b) => a.localeCompare(b)); // alphabetical
-        for (const o of ordered)
-            cols.push({ value: o, label: o });
-    }
-    const isRequired = Boolean(branch.requiredOnCreate || branch.requiredOnUpdate);
-    if (!isRequired) {
-        cols.push({ value: null, label: `Senza ${branch.label}` }); // always last if not required
+        for (const option of branch.options ?? []) {
+            cols.push({ value: option.value, label: option.value, color: option.color });
+        }
     }
+    const nullColumn = { value: null, label: `Senza ${branch.label}` };
+    cols.push(isKanbanAxisRequired(branch) ? { ...nullColumn, fallback: true } : nullColumn);
     return cols;
 }
+/**
+ * The entry value that puts an entry in the kanban column `columnValue` of `branch`:
+ * boolean → `true`/`false` (`null` column → `null`), tags → `[columnValue]` (`null` column → `[]`),
+ * any other type → `columnValue` unchanged. Pure.
+ */
+export function kanbanColumnEntryValue(branch, columnValue) {
+    if (branch.type === 'boolean')
+        return columnValue === null ? null : columnValue === 'true';
+    if (branch.type === 'tags')
+        return columnValue === null ? [] : [columnValue];
+    return columnValue;
+}
+/**
+ * Pure: the FilterGroup selecting one kanban column's entries for a given axis branch.
+ * `value: null` ⇒ "Senza valore" — entries where the axis field is NULL or empty (KB-U25).
+ * On a tags axis with options it also holds entries whose stored value is no longer an option
+ * (removed or renamed in the seed): `not_in` the option values matches both, so no entry
+ * falls outside every column.
+ * Boolean descriptor values 'true'/'false' are coerced to actual booleans for the engine.
+ */
 export function kanbanColumnFilter(branch, value) {
     if (value === null) {
+        const optionValues = branch.type === 'tags' ? tagOptionValues(branch) : [];
+        if (optionValues.length > 0) {
+            return { column: branch.alias, type: 'tags', conditions: [{ op: 'not_in', value: optionValues }] };
+        }
         const type = branch.type === 'boolean' ? 'boolean' : branch.type === 'tags' ? 'tags' : 'text';
         return { column: branch.alias, type, conditions: [{ op: 'is_empty', value: null }] };
     }