@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 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. Verificar que todo está verde
589
- npx nx run @danielitouci96/design-system:test
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. Subir la versión (actualiza package.json)
593
- npm version patch # o minor / major
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. Escribir el CHANGELOG y hacer commit de ambos
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. Crear el tarball (prepack compila automáticamente)
600
- npm pack --pack-destination artifacts ./packages/design-system
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
- Publicar en **npmjs**, que es el destino por defecto, requiere una cuenta en npmjs.org con **2FA
604
- activado**. npm ya no admite publicar con contraseña: se usa un *automation token*.
605
-
606
- ```bash
607
- # 1. En npmjs.com -> tu perfil -> Access Tokens -> Generate New Token
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
- El `publishConfig` del paquete es `{ "access": "public" }` y **no** fija registry, a propósito: un
617
- `npm publish` a secas va a npmjs y nace público, que es el destino principal. Fijar aquí el registry
618
- de GitHub Packages sería una trampa, porque en un `npm publish` sin flags ganaría el `publishConfig` y
619
- el paquete se iría al registry equivocado y con visibilidad equivocada.
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
- Publicar **no** es obligatorio: el tarball del paso 4 ya es consumible por cualquier app del equipo.
635
- Es el plan B para redes sin salida a internet.
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"}