orbital-ds 0.36.0 → 0.40.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.
Files changed (56) hide show
  1. package/AGENTS.md +1 -1
  2. package/components.manifest.json +147 -15
  3. package/dist/hooks/use-ds-messages.d.ts +25 -0
  4. package/dist/hooks/use-in-view.d.ts +9 -0
  5. package/dist/hooks/use-in-view.js +33 -0
  6. package/dist/lib/i18n.d.ts +25 -0
  7. package/dist/lib/i18n.js +75 -0
  8. package/dist/lib/image-upload.d.ts +41 -0
  9. package/dist/lib/image-upload.js +66 -0
  10. package/dist/styles.css +16 -0
  11. package/dist/themes/lagoon.css +4 -1
  12. package/dist/themes/lagoon.scoped.css +4 -1
  13. package/dist/ui/badge.d.ts +5 -1
  14. package/dist/ui/badge.js +23 -3
  15. package/dist/ui/card.d.ts +16 -1
  16. package/dist/ui/card.js +35 -3
  17. package/dist/ui/checkbox.js +1 -1
  18. package/dist/ui/choice-card.js +1 -1
  19. package/dist/ui/combobox.js +1 -1
  20. package/dist/ui/confirm-dialog.d.ts +21 -0
  21. package/dist/ui/confirm-dialog.js +54 -0
  22. package/dist/ui/content-card.d.ts +20 -3
  23. package/dist/ui/content-card.js +66 -38
  24. package/dist/ui/error-state.d.ts +16 -0
  25. package/dist/ui/error-state.js +42 -0
  26. package/dist/ui/input-group.js +1 -1
  27. package/dist/ui/input-otp.js +1 -1
  28. package/dist/ui/input.js +1 -1
  29. package/dist/ui/instruction-editor.d.ts +15 -2
  30. package/dist/ui/instruction-editor.js +139 -16
  31. package/dist/ui/load-more.d.ts +19 -0
  32. package/dist/ui/load-more.js +72 -0
  33. package/dist/ui/loading-state.d.ts +5 -1
  34. package/dist/ui/loading-state.js +16 -12
  35. package/dist/ui/mosaic.d.ts +4 -2
  36. package/dist/ui/mosaic.js +13 -2
  37. package/dist/ui/native-select.js +1 -1
  38. package/dist/ui/questionnaire.js +4 -4
  39. package/dist/ui/radio-group.js +1 -1
  40. package/dist/ui/reveal.d.ts +11 -0
  41. package/dist/ui/reveal.js +39 -0
  42. package/dist/ui/scroll-area.js +1 -1
  43. package/dist/ui/search-box.d.ts +32 -0
  44. package/dist/ui/search-box.js +238 -0
  45. package/dist/ui/select.js +1 -1
  46. package/dist/ui/show-more.d.ts +12 -0
  47. package/dist/ui/show-more.js +66 -0
  48. package/dist/ui/skeleton.d.ts +7 -2
  49. package/dist/ui/skeleton.js +19 -3
  50. package/dist/ui/slider.d.ts +19 -2
  51. package/dist/ui/textarea.js +1 -1
  52. package/docs/designer/criterio.md +87 -0
  53. package/docs/designer/revision.md +11 -0
  54. package/package.json +18 -8
  55. package/scripts/cli.mjs +1 -0
  56. package/skill/SKILL.md +7 -3
package/AGENTS.md CHANGED
@@ -151,7 +151,7 @@ la app (bloque de imports en orden), anota DESIGN.md, instala Motion y pasa el d
151
151
 
152
152
  Para crear o revisar pantallas y flujos, sigue `docs/designer/`: **flujo.md** (contexto real, modo, mapa del flujo y
153
153
  modelo mental de la persona, orden de autoridad), **patrones.md** (P1–P12: página, lista de entidades, detalle, tabla,
154
- formulario, asistente, panel de datos, destructiva, estados, avisos, búsqueda, ajustes), **ux.md** (heurísticas,
154
+ formulario, asistente, panel de datos, destructiva, estados, avisos, búsqueda, ajustes), **criterio.md** (análisis visual en 8 pasos con puntuación, árbol «¿tarjeta, ítem, bento, imagen, efecto?», armonía, referentes Apple/Material/Nielsen/Polaris), **ux.md** (heurísticas,
155
155
  carga cognitiva, formularios, textos, WCAG 2.2 AA, responsivo) y **revision.md** (lista observable y anti-patrones).
156
156
  Regla de oro: **nunca te sales del sistema**; si algo no se puede hacer con componentes y variables, se anota como hueco.
157
157
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "package": "orbital-ds",
3
- "version": "0.36.0",
3
+ "version": "0.40.0",
4
4
  "engine": "@base-ui/react",
5
5
  "docs": [
6
6
  "README.md",
@@ -392,8 +392,13 @@
392
392
  "Badge",
393
393
  "badgeVariants"
394
394
  ],
395
- "slots": [],
396
- "optionalPeers": []
395
+ "slots": [
396
+ "badge-dot"
397
+ ],
398
+ "optionalPeers": [],
399
+ "notes": [
400
+ "`dot` pone el punto de estado delante de la etiqueta y `size=\"sm\"` la compacta (listas densas, celdas de tabla). Para un estado con pulso o nivel semántico, mejor StatusBadge."
401
+ ]
397
402
  },
398
403
  "banner": {
399
404
  "import": "orbital-ds/ui/banner",
@@ -552,7 +557,11 @@
552
557
  "card-header",
553
558
  "card-title"
554
559
  ],
555
- "optionalPeers": []
560
+ "optionalPeers": [],
561
+ "notes": [
562
+ "`hoverable` eleva la tarjeta al señalarla; `spotlight` añade un foco de luz que sigue al ratón (solo puntero fino, quieto con movimiento reducido); `glow` un resplandor de marca. Valores en `--ds-card-hover-*`, `--ds-card-spotlight*` y `--ds-card-glow`.",
563
+ "`backdrop` (mesh · aurora · image · dots · grid…) pone un fondo de AuthBackdrop detrás del contenido; con `backdropGlass` suma cristal. Con texto sobre imagen o mesh, usa ContentCard preset=\"cover\" (lleva velo para el contraste) o pon el texto sobre una placa; no confíes en el color del fondo."
564
+ ]
556
565
  },
557
566
  "carousel": {
558
567
  "import": "orbital-ds/ui/carousel",
@@ -819,6 +828,22 @@
819
828
  "El título nombra la acción y el objeto; el botón repite el verbo, no «Aceptar»."
820
829
  ]
821
830
  },
831
+ "confirm-dialog": {
832
+ "import": "orbital-ds/ui/confirm-dialog",
833
+ "exports": [
834
+ "ConfirmDialogProvider",
835
+ "type ConfirmOptions",
836
+ "useConfirm"
837
+ ],
838
+ "slots": [
839
+ "confirm-action"
840
+ ],
841
+ "optionalPeers": [],
842
+ "notes": [
843
+ "Para «borrar» o «descartar» llamado desde un manejador (`if (await confirm(...))`): sin `useState` de apertura en cada pantalla. Si el diálogo vive junto a un botón concreto, usa ConfirmAction.",
844
+ "Un solo provider en la raíz; el título nombra la acción y el objeto y el botón repite el verbo. Cancelar, Escape o clic fuera resuelven `false`."
845
+ ]
846
+ },
822
847
  "connected-accounts": {
823
848
  "import": "orbital-ds/ui/connected-accounts",
824
849
  "exports": [
@@ -856,8 +881,12 @@
856
881
  ],
857
882
  "slots": [
858
883
  "content-card",
884
+ "content-card-body",
885
+ "content-card-cover",
859
886
  "content-card-dot",
887
+ "content-card-layout",
860
888
  "content-card-media",
889
+ "content-card-scrim",
861
890
  "content-card-value"
862
891
  ],
863
892
  "optionalPeers": [],
@@ -868,7 +897,8 @@
868
897
  "media",
869
898
  "horizontal",
870
899
  "metric",
871
- "status"
900
+ "status",
901
+ "cover"
872
902
  ],
873
903
  "default": "basic",
874
904
  "intent": {
@@ -881,7 +911,9 @@
881
911
  }
882
912
  },
883
913
  "notes": [
884
- "Tarjeta de contenido para rejillas: `basic` (texto), `feature` (icono + capacidad), `media` (portada arriba), `horizontal` (portada al lado), `metric` (un dato grande: `value` y `delta`), `status` (punto de estado con `tone` + texto). El énfasis (`elevated`, `outlined`, `filled`, `ghost`) cambia la prominencia, no la estructura.",
914
+ "Tipografía y relleno: `titleSize` `lg`/`xl` (`--ds-card-title-lg/-xl`, en rem) para titulares que mandan; `plate=\"blur\"` (solo `cover`) pone el texto sobre una placa de imagen desenfocada (`--ds-card-cover-blur`, `--ds-card-cover-plate`) y mantiene el contraste; `padding=\"none\"` deja el contenido (`children`) a sangre, para gráficos o tablas; cabecera y pie conservan su margen. Un titular grande por vista.",
915
+ "Fondos y efectos: `backdrop` (mesh · aurora · image…), `backdropGlass`, `spotlight` y `glow` pasan a Card. `cover` es la forma segura de poner texto sobre una foto: el velo es obligatorio y sale de `--ds-card-scrim` (ajústalo en brand.css, mide su contraste).",
916
+ "Tarjeta de contenido para rejillas: `basic` (texto), `feature` (icono + capacidad), `media` (portada arriba), `horizontal` (portada al lado), `metric` (un dato grande: `value` y `delta`), `status` (punto de estado con `tone` + texto), `cover` (la portada `media` a sangre con velo `--ds-card-scrim` para que el texto se lea: la celda destacada de un bento). El énfasis (`elevated`, `outlined`, `filled`, `ghost`) cambia la prominencia, no la estructura.",
885
917
  "Interactiva con `href` (navega) o `onSelect` (acción): toda la tarjeta es el objetivo y el título el enlace; no metas botones dentro de un enlace ni tarjetas dentro de tarjetas. Para filas de entidades usa Item variant=\"card\"; para cifras, Stat.",
886
918
  "Para disponer varias, Mosaic (even · bento · trio)."
887
919
  ]
@@ -1342,6 +1374,20 @@
1342
1374
  "Siempre con una salida: `actions` con un botón principal (inicio, reintentar, volver). Para la ruta desconocida de un router, monta ErrorPage en su componente de «no encontrado»."
1343
1375
  ]
1344
1376
  },
1377
+ "error-state": {
1378
+ "import": "orbital-ds/ui/error-state",
1379
+ "exports": [
1380
+ "ErrorState"
1381
+ ],
1382
+ "slots": [
1383
+ "empty-state",
1384
+ "error-state-retry"
1385
+ ],
1386
+ "optionalPeers": [],
1387
+ "notes": [
1388
+ "Para el fallo de carga de una lista, tarjeta o sección: título y descripción por defecto y botón de reintento. `description` admite el mensaje del error si es seguro mostrarlo. Página completa → ErrorPage; sin datos y sin fallo → EmptyState."
1389
+ ]
1390
+ },
1345
1391
  "eyebrow": {
1346
1392
  "import": "orbital-ds/ui/eyebrow",
1347
1393
  "exports": [
@@ -1620,6 +1666,7 @@
1620
1666
  "instruction-editor",
1621
1667
  "instruction-editor-body",
1622
1668
  "instruction-editor-count",
1669
+ "instruction-editor-image-status",
1623
1670
  "instruction-editor-issues",
1624
1671
  "instruction-editor-preview",
1625
1672
  "instruction-editor-snippets",
@@ -1628,7 +1675,9 @@
1628
1675
  "instruction-editor-variables"
1629
1676
  ],
1630
1677
  "optionalPeers": [
1678
+ "@tiptap/extension-image",
1631
1679
  "@tiptap/extension-placeholder",
1680
+ "@tiptap/extension-table",
1632
1681
  "@tiptap/markdown",
1633
1682
  "@tiptap/react",
1634
1683
  "@tiptap/starter-kit"
@@ -1648,8 +1697,11 @@
1648
1697
  },
1649
1698
  "notes": [
1650
1699
  "Preset `prompt` para instrucciones o prompts de sistema (el modelo recibe el Markdown); `document` para texto largo con vista HTML; `compact` para notas y comentarios.",
1651
- "Tiptap es dependencia opcional: instala `@tiptap/react @tiptap/pm @tiptap/starter-kit @tiptap/markdown @tiptap/extension-placeholder`. Carga el componente con `React.lazy` si quieres que no pese en el resto de la app.",
1700
+ "Tiptap es dependencia opcional: instala `@tiptap/react @tiptap/pm @tiptap/starter-kit @tiptap/markdown @tiptap/extension-placeholder @tiptap/extension-table`. Carga el componente con `React.lazy` si quieres que no pese en el resto de la app.",
1652
1701
  "En la vista Markdown la barra inserta la sintaxis en el texto (##, **, listas, citas, bloque de código) sobre la selección y la quita si ya está; sin deshacer/rehacer propios (usa el del navegador).",
1702
+ "Seguridad: la extensión de imagen solo se registra con `onUploadImage`; sin él, un `![](https://…)` del Markdown no se pinta (no se cargan recursos externos de un texto que no es de confianza). Con él, las imágenes del documento se cargan desde su URL: sirve las tuyas desde un dominio propio y, si el texto viene de terceros, valida las URL en la app.",
1703
+ "Imágenes: con `onUploadImage` (file → URL) aparece el botón de imagen y se admiten pegar y arrastrar. orbital-ds no conoce el almacenamiento: `createPresignedUploader` (S3 y R2 por URL prefirmada) y `createEndpointUploader` (un Worker con R2, una API) de `orbital-ds/lib/image-upload` lo conectan; las claves viven en el servidor. En Markdown queda `![alt](url)`.",
1704
+ "Títulos H1–H3 por defecto (`headingLevels` los cambia). Tablas: la herramienta `table` inserta una de 3×3 con cabecera y, dentro de ella, añade/quita filas y columnas; sale como tabla Markdown (GFM). Sin celdas combinadas ni listas dentro de la celda: Markdown no las admite.",
1653
1705
  "La vista HTML es solo de lectura (no se edita HTML ni se inyecta con innerHTML): la fuente de verdad es el Markdown.",
1654
1706
  "Las variables se insertan como texto `{{nombre}}`; sustituirlas al enviar el prompt es cosa de la app.",
1655
1707
  "`syntax=\"template\"` reconoce `{{v | \"x\"}}`, `{{v ? \"a\" : \"b\"}}`, `[[IF]]/[[ELSE]]/[[UNLESS]]`: añade fragmentos a la barra y avisa de condiciones que el motor trataría como falsas, bloques sin cerrar y variables fuera de `variables`. El editor no renderiza plantillas.",
@@ -1745,6 +1797,22 @@
1745
1797
  ],
1746
1798
  "optionalPeers": []
1747
1799
  },
1800
+ "load-more": {
1801
+ "import": "orbital-ds/ui/load-more",
1802
+ "exports": [
1803
+ "LoadMore"
1804
+ ],
1805
+ "slots": [
1806
+ "load-more",
1807
+ "load-more-button",
1808
+ "load-more-status"
1809
+ ],
1810
+ "optionalPeers": [],
1811
+ "notes": [
1812
+ "Para listas largas que se piden por tramos: el botón es lo principal y `auto` solo un extra (hasta `autoLimit` cargas). La lista debe conservar el foco y la posición; añade los elementos nuevos al final y pasa `loadedCount`. Para saltar a una página concreta o datos de trabajo (tablas), usa Pagination.",
1813
+ "Con error no reintenta solo: el botón pasa a «Reintentar»."
1814
+ ]
1815
+ },
1748
1816
  "loading-state": {
1749
1817
  "import": "orbital-ds/ui/loading-state",
1750
1818
  "exports": [
@@ -1752,7 +1820,8 @@
1752
1820
  "type LoadingStatePreset"
1753
1821
  ],
1754
1822
  "slots": [
1755
- "loading-state"
1823
+ "loading-state",
1824
+ "loading-state-label"
1756
1825
  ],
1757
1826
  "optionalPeers": [],
1758
1827
  "presets": {
@@ -1771,7 +1840,8 @@
1771
1840
  }
1772
1841
  },
1773
1842
  "notes": [
1774
- "Mientras carga, pinta la forma de lo que vendrá: `list` para filas, `card` para una tarjeta, `table` para una tabla, `detail` para una ficha."
1843
+ "Mientras carga, pinta la forma de lo que vendrá: `list` para filas, `card` para una tarjeta, `table` para una tabla, `detail` para una ficha.",
1844
+ "`label` añade un texto visible bajo la forma (p. ej. el nombre de lo que se carga); `shimmer` cambia el latido por un brillo."
1775
1845
  ]
1776
1846
  },
1777
1847
  "locale-switcher": {
@@ -1986,17 +2056,22 @@
1986
2056
  "values": [
1987
2057
  "even",
1988
2058
  "bento",
1989
- "trio"
2059
+ "trio",
2060
+ "hero",
2061
+ "showcase"
1990
2062
  ],
1991
2063
  "default": "even",
1992
2064
  "intent": {
1993
2065
  "even": "columnas iguales (1 → 2 → 3), sin jerarquía",
1994
2066
  "bento": "4 columnas anchas; el primer hijo ocupa 2×2 (lo más importante, más grande)",
1995
- "trio": "exactamente 3 en fila ancha, 1 en estrecho (tres capacidades, tres pasos)"
2067
+ "trio": "exactamente 3 en fila ancha, 1 en estrecho (tres capacidades, tres pasos)",
2068
+ "hero": "3 columnas; el primero ocupa 2×2 y a su lado una columna de pequeños (portada + resumen)",
2069
+ "showcase": "6 columnas; un grande 4×2, dos a su lado y el resto de a 2 (escaparate de producto)"
1996
2070
  }
1997
2071
  },
1998
2072
  "notes": [
1999
2073
  "Rejilla de tarjetas con jerarquía: `bento` para destacar lo primero, `trio` para tres iguales, `even` sin jerarquía. Si todo pesa lo mismo, usa `even` (o EntityList grid), no bento. Para spans manuales envuelve en MosaicItem.",
2074
+ "`hero` y `showcase` para portadas y escaparates; `MosaicItem tone` (`muted`, `brand`) alterna el ritmo: una celda de marca por rejilla, no más. Un solo destacado; celdas con gráficos (Sparkline, ChartCard glance) en 1×1 o 2×1, un mensaje por celda.",
2000
2075
  "El destacado va el primero del DOM (orden de lectura); no reordenes con CSS."
2001
2076
  ]
2002
2077
  },
@@ -2496,6 +2571,21 @@
2496
2571
  "react-resizable-panels"
2497
2572
  ]
2498
2573
  },
2574
+ "reveal": {
2575
+ "import": "orbital-ds/ui/reveal",
2576
+ "exports": [
2577
+ "Reveal",
2578
+ "type RevealEffect"
2579
+ ],
2580
+ "slots": [
2581
+ "reveal"
2582
+ ],
2583
+ "optionalPeers": [],
2584
+ "notes": [
2585
+ "Para tarjetas y bloques que quedan fuera de la primera pantalla; lo que ya se ve al cargar no necesita Reveal. En listas, `index` da la cascada; no lo uses en listas que se filtran o reordenan (reanimarían).",
2586
+ "Es CSS con IntersectionObserver: no necesita Motion. Para salidas, gestos o animar el layout, `useDsMotion()` con Motion."
2587
+ ]
2588
+ },
2499
2589
  "scroll-area": {
2500
2590
  "import": "orbital-ds/ui/scroll-area",
2501
2591
  "exports": [
@@ -2511,6 +2601,27 @@
2511
2601
  ],
2512
2602
  "optionalPeers": []
2513
2603
  },
2604
+ "search-box": {
2605
+ "import": "orbital-ds/ui/search-box",
2606
+ "exports": [
2607
+ "SearchBox",
2608
+ "type SearchQueryOptions",
2609
+ "type SearchSuggestion"
2610
+ ],
2611
+ "slots": [
2612
+ "search-box",
2613
+ "search-box-group",
2614
+ "search-box-input",
2615
+ "search-box-list",
2616
+ "search-box-option",
2617
+ "search-box-status"
2618
+ ],
2619
+ "optionalPeers": [],
2620
+ "notes": [
2621
+ "Para buscar mientras se escribe (navegación, catálogo, ayuda): la app aporta `onQuery` (con `signal`) y recientes/populares; el componente pone el combobox accesible, la espera, el resaltado y los estados. Para elegir un valor de una lista cerrada → Combobox; para ir a una pantalla con ⌘K → CommandPalette.",
2622
+ "Guarda los «recientes» en la app y no pongas en las sugerencias datos que la persona no puede ver. No reveles si algo existe si la búsqueda es de cuentas."
2623
+ ]
2624
+ },
2514
2625
  "select": {
2515
2626
  "import": "orbital-ds/ui/select",
2516
2627
  "exports": [
@@ -2635,6 +2746,21 @@
2635
2746
  "Nivel de protección 0–1; con decorative si solo adorna. ShieldRadar para protegido/alerta con latido del tema."
2636
2747
  ]
2637
2748
  },
2749
+ "show-more": {
2750
+ "import": "orbital-ds/ui/show-more",
2751
+ "exports": [
2752
+ "ShowMore"
2753
+ ],
2754
+ "slots": [
2755
+ "show-more",
2756
+ "show-more-content",
2757
+ "show-more-toggle"
2758
+ ],
2759
+ "optionalPeers": [],
2760
+ "notes": [
2761
+ "Para descripciones, reseñas o notas largas dentro de una tarjeta: se recorta y se expande en el sitio. Si el texto cabe, no hay botón. Para un bloque que se pliega con más contenido (formularios, filtros) usa Collapsible."
2762
+ ]
2763
+ },
2638
2764
  "sidebar": {
2639
2765
  "import": "orbital-ds/ui/sidebar",
2640
2766
  "exports": [
@@ -2728,20 +2854,23 @@
2728
2854
  "skeleton": {
2729
2855
  "import": "orbital-ds/ui/skeleton",
2730
2856
  "exports": [
2731
- "Skeleton"
2857
+ "Skeleton",
2858
+ "skeletonVariants"
2732
2859
  ],
2733
2860
  "slots": [
2734
2861
  "skeleton"
2735
2862
  ],
2736
2863
  "optionalPeers": [],
2737
2864
  "notes": [
2738
- "Cargando: Skeleton con la forma del contenido, no un spinner a pantalla completa."
2865
+ "Cargando: Skeleton con la forma del contenido, no un spinner a pantalla completa.",
2866
+ "`variant=\"shimmer\"` pasa un brillo por el bloque (ritmo `--ds-motion-shimmer`, quieto con movimiento reducido); el `default` late. Úsalo en tarjetas y bloques grandes."
2739
2867
  ]
2740
2868
  },
2741
2869
  "slider": {
2742
2870
  "import": "orbital-ds/ui/slider",
2743
2871
  "exports": [
2744
- "Slider"
2872
+ "Slider",
2873
+ "type SliderProps"
2745
2874
  ],
2746
2875
  "slots": [
2747
2876
  "slider",
@@ -2750,7 +2879,10 @@
2750
2879
  "slider-thumb",
2751
2880
  "slider-track"
2752
2881
  ],
2753
- "optionalPeers": []
2882
+ "optionalPeers": [],
2883
+ "notes": [
2884
+ "Con un número en `value`/`defaultValue` hay UN tirador y `onValueChange` recibe un número; con una lista, un rango y recibe una lista. Sin normalizar a mano en cada uso."
2885
+ ]
2754
2886
  },
2755
2887
  "sonner": {
2756
2888
  "import": "orbital-ds/ui/sonner",
@@ -128,6 +128,19 @@ declare const DsMessagesContext: React.Context<{
128
128
  noticeStateAcknowledged: string;
129
129
  noticeStateResolved: string;
130
130
  entityRetry: string;
131
+ showMore: string;
132
+ showLess: string;
133
+ loadMore: string;
134
+ loadMoreDone: string;
135
+ loadMoreEnd: string;
136
+ searchPlaceholder: string;
137
+ searchClear: string;
138
+ searchRecent: string;
139
+ searchPopular: string;
140
+ searchResults: string;
141
+ searchNoResults: string;
142
+ searchCount: string;
143
+ searchError: string;
131
144
  statIncrease: string;
132
145
  statDecrease: string;
133
146
  statNoChange: string;
@@ -154,6 +167,18 @@ declare const DsMessagesContext: React.Context<{
154
167
  editorStrike: string;
155
168
  editorCode: string;
156
169
  editorHeading: string;
170
+ editorHeadingLevel: string;
171
+ editorTable: string;
172
+ editorTableAddRow: string;
173
+ editorTableAddColumn: string;
174
+ editorTableDeleteRow: string;
175
+ editorTableDeleteColumn: string;
176
+ editorTableDelete: string;
177
+ editorImage: string;
178
+ editorImageUploading: string;
179
+ editorImageError: string;
180
+ editorImageType: string;
181
+ editorImageSize: string;
157
182
  editorBulletList: string;
158
183
  editorOrderedList: string;
159
184
  editorQuote: string;
@@ -0,0 +1,9 @@
1
+ import * as React from 'react';
2
+
3
+ declare function useInView<T extends Element = HTMLElement>({ once, threshold, rootMargin, }?: {
4
+ once?: boolean;
5
+ threshold?: number;
6
+ rootMargin?: string;
7
+ }): readonly [React.Dispatch<React.SetStateAction<T | null>>, boolean];
8
+
9
+ export { useInView };
@@ -0,0 +1,33 @@
1
+ "use client";
2
+ import * as React from "react";
3
+ function useInView({
4
+ once = true,
5
+ threshold = 0.15,
6
+ rootMargin = "0px 0px -8% 0px"
7
+ } = {}) {
8
+ const [node, setNode] = React.useState(null);
9
+ const [inView, setInView] = React.useState(false);
10
+ React.useEffect(() => {
11
+ if (!node) return;
12
+ if (typeof IntersectionObserver === "undefined") {
13
+ setInView(true);
14
+ return;
15
+ }
16
+ const io = new IntersectionObserver(
17
+ ([entry]) => {
18
+ if (!entry) return;
19
+ if (entry.isIntersecting) {
20
+ setInView(true);
21
+ if (once) io.disconnect();
22
+ } else if (!once) setInView(false);
23
+ },
24
+ { threshold, rootMargin }
25
+ );
26
+ io.observe(node);
27
+ return () => io.disconnect();
28
+ }, [node, once, threshold, rootMargin]);
29
+ return [setNode, inView];
30
+ }
31
+ export {
32
+ useInView
33
+ };
@@ -127,6 +127,19 @@ declare const en: {
127
127
  noticeStateAcknowledged: string;
128
128
  noticeStateResolved: string;
129
129
  entityRetry: string;
130
+ showMore: string;
131
+ showLess: string;
132
+ loadMore: string;
133
+ loadMoreDone: string;
134
+ loadMoreEnd: string;
135
+ searchPlaceholder: string;
136
+ searchClear: string;
137
+ searchRecent: string;
138
+ searchPopular: string;
139
+ searchResults: string;
140
+ searchNoResults: string;
141
+ searchCount: string;
142
+ searchError: string;
130
143
  statIncrease: string;
131
144
  statDecrease: string;
132
145
  statNoChange: string;
@@ -153,6 +166,18 @@ declare const en: {
153
166
  editorStrike: string;
154
167
  editorCode: string;
155
168
  editorHeading: string;
169
+ editorHeadingLevel: string;
170
+ editorTable: string;
171
+ editorTableAddRow: string;
172
+ editorTableAddColumn: string;
173
+ editorTableDeleteRow: string;
174
+ editorTableDeleteColumn: string;
175
+ editorTableDelete: string;
176
+ editorImage: string;
177
+ editorImageUploading: string;
178
+ editorImageError: string;
179
+ editorImageType: string;
180
+ editorImageSize: string;
156
181
  editorBulletList: string;
157
182
  editorOrderedList: string;
158
183
  editorQuote: string;
package/dist/lib/i18n.js CHANGED
@@ -126,6 +126,19 @@ const en = {
126
126
  noticeStateAcknowledged: "Acknowledged",
127
127
  noticeStateResolved: "Resolved",
128
128
  entityRetry: "Try again",
129
+ showMore: "Show more",
130
+ showLess: "Show less",
131
+ loadMore: "Load more",
132
+ loadMoreDone: "{count} more items loaded",
133
+ loadMoreEnd: "You have reached the end",
134
+ searchPlaceholder: "Search\u2026",
135
+ searchClear: "Clear search",
136
+ searchRecent: "Recent",
137
+ searchPopular: "Popular",
138
+ searchResults: "Results",
139
+ searchNoResults: "No results for \u201C{query}\u201D",
140
+ searchCount: "Results: {count}",
141
+ searchError: "The search failed",
129
142
  statIncrease: "Increase",
130
143
  statDecrease: "Decrease",
131
144
  statNoChange: "No change",
@@ -152,6 +165,18 @@ const en = {
152
165
  editorStrike: "Strikethrough",
153
166
  editorCode: "Inline code",
154
167
  editorHeading: "Heading",
168
+ editorHeadingLevel: "Heading {level}",
169
+ editorTable: "Insert table",
170
+ editorTableAddRow: "Add row",
171
+ editorTableAddColumn: "Add column",
172
+ editorTableDeleteRow: "Delete row",
173
+ editorTableDeleteColumn: "Delete column",
174
+ editorTableDelete: "Delete table",
175
+ editorImage: "Insert image",
176
+ editorImageUploading: "Uploading image\u2026",
177
+ editorImageError: "The image could not be uploaded.",
178
+ editorImageType: "That file is not a supported image.",
179
+ editorImageSize: "The image is too large.",
155
180
  editorBulletList: "Bulleted list",
156
181
  editorOrderedList: "Numbered list",
157
182
  editorQuote: "Quote",
@@ -546,6 +571,19 @@ const es = {
546
571
  noticeStateAcknowledged: "Reconocido",
547
572
  noticeStateResolved: "Resuelto",
548
573
  entityRetry: "Reintentar",
574
+ showMore: "Ver m\xE1s",
575
+ showLess: "Ver menos",
576
+ loadMore: "Cargar m\xE1s",
577
+ loadMoreDone: "{count} elementos m\xE1s cargados",
578
+ loadMoreEnd: "Has llegado al final",
579
+ searchPlaceholder: "Buscar\u2026",
580
+ searchClear: "Borrar la b\xFAsqueda",
581
+ searchRecent: "Recientes",
582
+ searchPopular: "Populares",
583
+ searchResults: "Resultados",
584
+ searchNoResults: "Sin resultados para \xAB{query}\xBB",
585
+ searchCount: "Resultados: {count}",
586
+ searchError: "La b\xFAsqueda ha fallado",
549
587
  statIncrease: "Subida",
550
588
  statDecrease: "Bajada",
551
589
  statNoChange: "Sin cambios",
@@ -572,6 +610,18 @@ const es = {
572
610
  editorStrike: "Tachado",
573
611
  editorCode: "C\xF3digo en l\xEDnea",
574
612
  editorHeading: "T\xEDtulo",
613
+ editorHeadingLevel: "T\xEDtulo {level}",
614
+ editorTable: "Insertar tabla",
615
+ editorTableAddRow: "A\xF1adir fila",
616
+ editorTableAddColumn: "A\xF1adir columna",
617
+ editorTableDeleteRow: "Eliminar fila",
618
+ editorTableDeleteColumn: "Eliminar columna",
619
+ editorTableDelete: "Eliminar tabla",
620
+ editorImage: "Insertar imagen",
621
+ editorImageUploading: "Subiendo imagen\u2026",
622
+ editorImageError: "No se pudo subir la imagen.",
623
+ editorImageType: "Ese archivo no es una imagen admitida.",
624
+ editorImageSize: "La imagen es demasiado grande.",
575
625
  editorBulletList: "Lista con vi\xF1etas",
576
626
  editorOrderedList: "Lista numerada",
577
627
  editorQuote: "Cita",
@@ -966,6 +1016,19 @@ const ptBR = {
966
1016
  noticeStateAcknowledged: "Reconhecido",
967
1017
  noticeStateResolved: "Resolvido",
968
1018
  entityRetry: "Tentar novamente",
1019
+ showMore: "Ver mais",
1020
+ showLess: "Ver menos",
1021
+ loadMore: "Carregar mais",
1022
+ loadMoreDone: "{count} itens a mais carregados",
1023
+ loadMoreEnd: "Voc\xEA chegou ao fim",
1024
+ searchPlaceholder: "Pesquisar\u2026",
1025
+ searchClear: "Limpar a pesquisa",
1026
+ searchRecent: "Recentes",
1027
+ searchPopular: "Populares",
1028
+ searchResults: "Resultados",
1029
+ searchNoResults: "Nenhum resultado para \u201C{query}\u201D",
1030
+ searchCount: "Resultados: {count}",
1031
+ searchError: "A pesquisa falhou",
969
1032
  statIncrease: "Aumento",
970
1033
  statDecrease: "Queda",
971
1034
  statNoChange: "Sem altera\xE7\xE3o",
@@ -992,6 +1055,18 @@ const ptBR = {
992
1055
  editorStrike: "Tachado",
993
1056
  editorCode: "C\xF3digo em linha",
994
1057
  editorHeading: "T\xEDtulo",
1058
+ editorHeadingLevel: "T\xEDtulo {level}",
1059
+ editorTable: "Inserir tabela",
1060
+ editorTableAddRow: "Adicionar linha",
1061
+ editorTableAddColumn: "Adicionar coluna",
1062
+ editorTableDeleteRow: "Excluir linha",
1063
+ editorTableDeleteColumn: "Excluir coluna",
1064
+ editorTableDelete: "Excluir tabela",
1065
+ editorImage: "Inserir imagem",
1066
+ editorImageUploading: "Enviando imagem\u2026",
1067
+ editorImageError: "N\xE3o foi poss\xEDvel enviar a imagem.",
1068
+ editorImageType: "Esse arquivo n\xE3o \xE9 uma imagem compat\xEDvel.",
1069
+ editorImageSize: "A imagem \xE9 grande demais.",
995
1070
  editorBulletList: "Lista com marcadores",
996
1071
  editorOrderedList: "Lista numerada",
997
1072
  editorQuote: "Cita\xE7\xE3o",
@@ -0,0 +1,41 @@
1
+ type ImageUploadResult = string | {
2
+ url: string;
3
+ alt?: string;
4
+ };
5
+ /** Sube una imagen y devuelve su URL pública (o `{ url, alt }`). Debe rechazar si falla. */
6
+ type ImageUploader = (file: File, options?: {
7
+ signal?: AbortSignal;
8
+ }) => Promise<ImageUploadResult>;
9
+ interface PresignedUpload {
10
+ /** URL a la que se hace el PUT del fichero. */
11
+ uploadUrl: string;
12
+ /** URL con la que se verá después la imagen (la que se guarda en el Markdown). */
13
+ publicUrl: string;
14
+ /** Cabeceras que la firma exige en el PUT (Content-Type se añade solo si falta). */
15
+ headers?: Record<string, string>;
16
+ }
17
+ declare class ImageUploadError extends Error {
18
+ readonly code: "type" | "size" | "network" | "response";
19
+ constructor(code: "type" | "size" | "network" | "response", message?: string);
20
+ }
21
+ /** Valida tipo y tamaño antes de subir. `accept` admite `image/*` o una lista de tipos MIME. */
22
+ declare function checkImageFile(file: File, { accept, maxBytes }?: {
23
+ accept?: string;
24
+ maxBytes?: number;
25
+ }): void;
26
+ /** S3 / R2 por URL prefirmada: pide la URL al servidor y hace el PUT. */
27
+ declare function createPresignedUploader({ getUploadUrl, fetcher, }: {
28
+ getUploadUrl: (file: File) => Promise<PresignedUpload>;
29
+ fetcher?: typeof fetch;
30
+ }): ImageUploader;
31
+ /** Endpoint propio (Worker con R2, API…): multipart POST con el fichero y respuesta JSON con `url`. */
32
+ declare function createEndpointUploader({ endpoint, fieldName, headers, parse, fetcher, }: {
33
+ endpoint: string;
34
+ fieldName?: string;
35
+ headers?: Record<string, string>;
36
+ /** Adapta la respuesta del servidor si no es `{ url }`. */
37
+ parse?: (json: unknown) => ImageUploadResult;
38
+ fetcher?: typeof fetch;
39
+ }): ImageUploader;
40
+
41
+ export { ImageUploadError, type ImageUploadResult, type ImageUploader, type PresignedUpload, checkImageFile, createEndpointUploader, createPresignedUploader };