@kenlo/kdls-design-system 2.0.5 → 2.6.0

package/README.md

@@ -11,9 +11,29 @@ kdls-design-system/
 ├── portal/          # app de documentação interativa (playgrounds)
 ├── docs/            # PATTERNS.md (receitas de UI)
 ├── .claude/         # CLAUDE.md (índice), component-rules.md, component-standard.md, tokens-reference.md (regras)
-└── scripts/         # geradores (ex.: styles.css)
+└── scripts/         # geradores (ex.: styles.css, kdls-manifest.json)
 ```
 
+## Manifesto — o catálogo que as máquinas leem
+
+`kdls-manifest.json` descreve este design system num arquivo só: os 55 componentes, as
+696 props com tipo, padrão, descrição e exemplo, os 381 tokens, e a linha de import exata
+de cada símbolo (`import type` quando é um tipo, e não um componente).
+
+**É gerado, nunca escrito à mão** — `npm run gen:manifest`, a partir das mesmas fontes que
+uma pessoa lê: `components/`, `portal/src/playground-utils/props-tables.ts`,
+`foundations/tokens.css` e o `package.json`. A esteira roda `--check` em toda merge
+request: se alguém mexer numa prop e não regenerar, o pipeline reprova. Um catálogo
+desatualizado é pior que nenhum — ele responde errado com a mesma confiança.
+
+Serve para o Kenlo Brain responder "preciso de um seletor de data" com o componente, as
+props e a linha de import, em vez de um resultado de busca. Está no pacote npm
+(`@kenlo/kdls-design-system/manifest.json`) e publicado junto do portal, onde pode ser
+lido sem credencial nenhuma.
+
+O manifesto também reporta a própria defasagem, no campo `drift`: componentes sem tabela
+de props (invisíveis para uma máquina) e tabelas sem componente correspondente.
+
 ## Tokens
 
 Os tokens ficam em `foundations/tokens.css` como CSS custom properties (`var(--spacing-4)`, `var(--color-primary-50)`), com auto-inversão light/dark. Escala de espaçamento em múltiplos de 4px. Catálogo completo em [`.claude/tokens-reference.md`](.claude/tokens-reference.md).

package/dist/components/Table/Table.d.ts

@@ -19,6 +19,13 @@ export interface TableColumn<T = Record<string, unknown>> {
     ellipsis?: boolean;
     /** true = sortable, sorting done by the backend (the component only reports state via onSortChange, doesn't reorder `rows`) · function = sorts on the frontend using this comparator — handle dates and numbers inside it, don't let the component guess the type */
     sortable?: boolean | ((a: T, b: T) => number);
+    /**
+     * Marks this column as a mobile-only action slot — has no effect above the mobile
+     * breakpoint. `'link'` pulls it out of the stack into a final row shared with any other
+     * `'link'` columns (one button: left-aligned; more than one: split evenly). `'icon'`
+     * (e.g. a chevron or a ••• menu) pins it to the row's top-right corner instead.
+     */
+    mobileAction?: 'link' | 'icon';
     /** Custom cell rendering — when omitted, displays row[key] directly */
     render?: (value: unknown, row: T, index: number) => React.ReactNode;
 }
@@ -31,6 +38,13 @@ export interface TableProps<T extends Record<string, unknown> = Record<string, u
     columns: TableColumn<T>[];
     /** Row data */
     rows: T[];
+    /**
+     * Layout of the table. `'default'` is a flush list — rows have no radius, no gap
+     * between them, divided by a top border only. `'cardLines'` keeps each row as an
+     * individual card instead (own border, radius, gap, plus the container's own padding).
+     * Background, the theme's radius and the bordered stroke behave the same in both.
+     */
+    variant?: 'default' | 'cardLines';
     /**
      * Shows a 1px neutral-20 border around the component. `false` by default.
      * Use `true` when the surrounding background matches the Table's background (--color-neutral-00) —