@danielitouci96/design-system 1.2.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +41 -0
- package/README.md +40 -25
- package/dist/components/Tree/Tree.d.ts +47 -0
- package/dist/components/Tree/Tree.d.ts.map +1 -0
- package/dist/design-system.css +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.es.js +7006 -6852
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,47 @@ Todas las versiones notables de `@danielitouci96/design-system`.
|
|
|
10
10
|
> que quedan en las entradas de abajo también se actualizaron. El nombre en npmjs es inmutable: una
|
|
11
11
|
> vez publicado, habría sido para siempre.
|
|
12
12
|
|
|
13
|
+
## [1.4.0] — 2026-11-14
|
|
14
|
+
|
|
15
|
+
### Tree y TreeToolbar
|
|
16
|
+
|
|
17
|
+
El árbol jerárquico de Tipología vivía en `g-clinica` con su propio CSS (animación de carpetas, filas, badges, código y estados de carga/error/vacío). Ese bloque era un componente genérico, no una decisión de dominio, así que pasa al design system.
|
|
18
|
+
|
|
19
|
+
- **`Tree`** es data-driven: recibe `TreeNode[]` con `id`, `label`, `icon`, `code`, `description`, `meta`, `actions`, `children` y `empty`. El componente resuelve la jerarquía, la indentación y las líneas de rama.
|
|
20
|
+
- **Estado controlado.** La expansión se controla con `expandedIds` (`ReadonlySet<string>`) y `onToggle`. No hay estado interno duplicado.
|
|
21
|
+
- **Estados completos.** `loading` con filas esqueleto, `error` y `empty` con slots; si hay `nodes`, esos estados no se muestran.
|
|
22
|
+
- **Accesibilidad.** La región lleva `aria-label`; las ramas son botones con `aria-expanded` y `aria-controls`; los iconos son decorativos y el foco tiene anillo visible. Se navega con Tab y se activa con Enter/Espacio, como cualquier botón nativo.
|
|
23
|
+
- **Animación sin medir alturas.** La apertura usa `grid-template-rows: 0fr → 1fr` y respeta `prefers-reduced-motion`.
|
|
24
|
+
- **`TreeToolbar`** agrupa búsqueda, resumen y acciones con el layout responsive del DS. En móvil la búsqueda ocupa la fila completa y las acciones se alinean a la izquierda; en escritorio se reparten en una sola fila.
|
|
25
|
+
|
|
26
|
+
### Tokens
|
|
27
|
+
|
|
28
|
+
Se añaden los tokens `--tree-*` y `--tree-toolbar-*` en `_data-display.scss`. Los alias que leen tokens base re-mapeados (`--tree-group-border`, `--tree-row-hover-background`, `--tree-icon-color-muted`, `--tree-code-background`, `--tree-code-text`, `--tree-leaf-background`, `--tree-leaf-border`, `--tree-state-text`) se re-declaran también en el scope `inverse`, según el invariante de `inverse-surface.spec.ts`.
|
|
29
|
+
|
|
30
|
+
## [1.3.0] — 2026-11-14
|
|
31
|
+
|
|
32
|
+
### PageHeader: más aire entre las acciones
|
|
33
|
+
|
|
34
|
+
Las acciones de la cabecera de página (`Actualizar`, `Exportar`, etc.) quedaban demasiado juntas
|
|
35
|
+
cuando se renderizaban como botones secundarios seguidos. El `gap` sube de `--space-component-sm`
|
|
36
|
+
(8px) a `--space-component-md` (12px), que es el mismo valor que g-clinica ya aplicaba como
|
|
37
|
+
override local en `src/styles/app.css`.
|
|
38
|
+
|
|
39
|
+
El contenedor también pasa a `flex-wrap: wrap` y `justify-content: flex-end`, para que un grupo de
|
|
40
|
+
acciones largo baje a la línea siguiente alineado a la derecha en vez de desbordar la cabecera.
|
|
41
|
+
|
|
42
|
+
**Compatibilidad con `Inline`.** Varias páginas de g-clinica envuelven los botones en `<Inline>`,
|
|
43
|
+
que fija su propio `gap` como estilo inline. Ese estilo gana sobre la clase del DS, así que
|
|
44
|
+
`.med-page-header__actions .med-inline` hereda el `gap` del contenedor. De este modo las páginas
|
|
45
|
+
con y sin wrapper mantienen la misma separación.
|
|
46
|
+
|
|
47
|
+
### Auditoría del CSS de g-clinica
|
|
48
|
+
|
|
49
|
+
Se revisaron los cambios de `g-clinica/src/styles/app.css` desde la publicación de `1.2.0`. El
|
|
50
|
+
único ajuste genérico de componente era la separación de las acciones de `PageHeader`; el resto
|
|
51
|
+
(toolbars de catálogos, árbol de tipología, drawers de dominio, fondo del dashboard y estilos de
|
|
52
|
+
informes) son decisiones de producto o de una vista concreta y siguen en la app.
|
|
53
|
+
|
|
13
54
|
## [1.2.0] — 2026-09-27
|
|
14
55
|
|
|
15
56
|
### Fix: los componentes ya no desaparecen sobre superficies `inverse`
|
package/README.md
CHANGED
|
@@ -584,39 +584,54 @@ CHANGELOG se escribe siempre mirando la diff visual, no solo el código.
|
|
|
584
584
|
|
|
585
585
|
### Para quien mantiene el paquete
|
|
586
586
|
|
|
587
|
+
Flujo completo de una versión publicable, tal y como se verificó al publicar `1.2.0`:
|
|
588
|
+
|
|
587
589
|
```bash
|
|
588
|
-
# 1.
|
|
589
|
-
|
|
590
|
-
npm run build:design-system
|
|
590
|
+
# 1. Toca el código en packages/design-system/src
|
|
591
|
+
# (los cambios de tokens a foundations/tokens/, los de componente a components/<x>/)
|
|
591
592
|
|
|
592
|
-
# 2.
|
|
593
|
-
|
|
593
|
+
# 2. Verifica: tests, typecheck y build
|
|
594
|
+
cd packages/design-system
|
|
595
|
+
npm test
|
|
596
|
+
npm run typecheck
|
|
597
|
+
npm run build
|
|
594
598
|
|
|
595
|
-
# 3.
|
|
596
|
-
git add packages/design-system/package.json packages/design-system/CHANGELOG.md
|
|
597
|
-
git commit -m "release(ds): 1.0.3"
|
|
599
|
+
# 3. Si cambió comportamiento o API: actualiza CHANGELOG.md y, si hace falta, README.md
|
|
598
600
|
|
|
599
|
-
# 4.
|
|
600
|
-
npm
|
|
601
|
-
```
|
|
601
|
+
# 4. Sube la versión (crea el tag git y actualiza package.json + package-lock)
|
|
602
|
+
npm version minor # patch = fix, minor = feature, major = breaking
|
|
602
603
|
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
# -> tipo "Automation", con el paquete y solo permiso "Read & Write"
|
|
609
|
-
# 2. El token va SIEMPRE en la variable de entorno, nunca en un archivo versionado
|
|
610
|
-
export NODE_AUTH_TOKEN="<token de automatización de npmjs>"
|
|
604
|
+
# 5. Commit y push del repo (incluye el tag)
|
|
605
|
+
cd ../..
|
|
606
|
+
git add -A
|
|
607
|
+
git commit -m "release(ds): <nueva version>"
|
|
608
|
+
git push origin main --tags
|
|
611
609
|
|
|
610
|
+
# 6. Publica: prepack compila solo, y con el publishConfig actual NO hacen falta flags
|
|
612
611
|
cd packages/design-system
|
|
613
612
|
npm publish
|
|
614
613
|
```
|
|
615
614
|
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
615
|
+
> npm eliminó los "automation tokens" clásicos en **noviembre de 2025**; solo existen los tokens
|
|
616
|
+
> **granulares**. Este repo usa un Granular Access Token con **Bypass 2FA** activado guardado en el
|
|
617
|
+
> `.npmrc` de la máquina. Por eso el flujo no muestra `--registry`, ni `NODE_AUTH_TOKEN`, ni `--otp`:
|
|
618
|
+
> con `publishConfig: { "access": "public" }` y sin registry, un `npm publish` a secas va a npmjs y
|
|
619
|
+
> nace en público. Si algún día falta ese token, se recrea en
|
|
620
|
+
> `/settings/danielitouci96/tokens/granular-access-tokens/new` con acceso
|
|
621
|
+
> **Read and write (publish and stage)** + **Bypass 2FA** marcado, y se guarda con
|
|
622
|
+
> `npm config set //registry.npmjs.org/:_authToken "npm_..."`.
|
|
623
|
+
|
|
624
|
+
**Consumir la versión nueva desde una app** (por ejemplo `g-clinica`):
|
|
625
|
+
|
|
626
|
+
```bash
|
|
627
|
+
cd ../g-clinica
|
|
628
|
+
npm install @danielitouci96/design-system@^<nueva version>
|
|
629
|
+
npm run build
|
|
630
|
+
```
|
|
631
|
+
|
|
632
|
+
Con el rango `^1.2.0`, cualquier versión `1.x` entra automáticamente, así que un `npm install` ya
|
|
633
|
+
bajaría la última; el `@^<version>` explícito sirve para ser deliberado. El `package-lock` cambia y
|
|
634
|
+
hay que commitearlo.
|
|
620
635
|
|
|
621
636
|
**Publicar también en GitHub Packages** es opt-in, con `--registry` explícito:
|
|
622
637
|
|
|
@@ -631,8 +646,8 @@ npm publish --registry https://npm.pkg.github.com
|
|
|
631
646
|
> publicada; hay que subir la siguiente. Por eso conviene publicar solo cuando los tests están en
|
|
632
647
|
> verde. Y ojo: en npmjs el **nombre** tampoco se puede cambiar una vez publicado.
|
|
633
648
|
|
|
634
|
-
|
|
635
|
-
|
|
649
|
+
> El tarball del paso `npm pack` se sigue generando en `artifacts/` como plan B para redes sin salida
|
|
650
|
+
> a internet, pero el flujo normal de una versión ahora es publicar.
|
|
636
651
|
|
|
637
652
|
### Automatizarlo
|
|
638
653
|
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import * as React from 'react';
|
|
2
|
+
import { type IconName } from '../../icons/Icon';
|
|
3
|
+
export interface TreeNode {
|
|
4
|
+
/** Stable id used for expansion state and aria-controls. */
|
|
5
|
+
id: string;
|
|
6
|
+
label: React.ReactNode;
|
|
7
|
+
/** Optional leading icon. */
|
|
8
|
+
icon?: IconName;
|
|
9
|
+
/** Short code rendered next to the label. */
|
|
10
|
+
code?: React.ReactNode;
|
|
11
|
+
/** Secondary line rendered below the label on leaf rows. */
|
|
12
|
+
description?: React.ReactNode;
|
|
13
|
+
/** Badges or counters rendered next to the branch row or leaf actions. */
|
|
14
|
+
meta?: React.ReactNode;
|
|
15
|
+
/** Leaf-only actions rendered on the right side. */
|
|
16
|
+
actions?: React.ReactNode;
|
|
17
|
+
/** Child nodes. Presence of this property makes the node expandable. */
|
|
18
|
+
children?: TreeNode[];
|
|
19
|
+
/** Message rendered when an expandable node has no children. */
|
|
20
|
+
empty?: React.ReactNode;
|
|
21
|
+
}
|
|
22
|
+
export interface TreeProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'onToggle'> {
|
|
23
|
+
nodes: TreeNode[];
|
|
24
|
+
/** Ids of the currently expanded branches. */
|
|
25
|
+
expandedIds: ReadonlySet<string>;
|
|
26
|
+
onToggle: (id: string) => void;
|
|
27
|
+
loading?: boolean;
|
|
28
|
+
loadingRows?: number;
|
|
29
|
+
error?: React.ReactNode;
|
|
30
|
+
empty?: React.ReactNode;
|
|
31
|
+
/** Accessible name for the tree region. */
|
|
32
|
+
label?: string;
|
|
33
|
+
}
|
|
34
|
+
declare const Tree: React.ForwardRefExoticComponent<TreeProps & React.RefAttributes<HTMLDivElement>>;
|
|
35
|
+
export interface TreeToolbarProps {
|
|
36
|
+
/** Search control, usually a SearchInput plus an optional clear action. */
|
|
37
|
+
search?: React.ReactNode;
|
|
38
|
+
/** Result summary, aligned to the right of the search row. */
|
|
39
|
+
summary?: React.ReactNode;
|
|
40
|
+
/** Secondary actions, rendered on their own row. */
|
|
41
|
+
actions?: React.ReactNode;
|
|
42
|
+
className?: string;
|
|
43
|
+
}
|
|
44
|
+
declare const TreeToolbar: React.ForwardRefExoticComponent<TreeToolbarProps & React.RefAttributes<HTMLDivElement>>;
|
|
45
|
+
export { Tree, TreeToolbar };
|
|
46
|
+
export default Tree;
|
|
47
|
+
//# sourceMappingURL=Tree.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Tree.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/Tree.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAID,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACpG,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgHD,QAAA,MAAM,IAAI,kFAoFR,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,QAAA,MAAM,WAAW,yFAef,CAAC;AAEH,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC7B,eAAe,IAAI,CAAC"}
|