shelving 1.314.0 → 1.315.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 (91) hide show
  1. package/docs/icon/AddIcon/AddIcon.md +8 -0
  2. package/docs/icon/AddIcon.md +8 -0
  3. package/docs/icon/CloseIcon/CloseIcon.md +8 -0
  4. package/docs/icon/CloseIcon.md +8 -0
  5. package/docs/icon/ErrorIcon/ErrorIcon.md +8 -0
  6. package/docs/icon/ErrorIcon.md +8 -0
  7. package/docs/icon/ExitFullscreenIcon/ExitFullscreenIcon.md +8 -0
  8. package/docs/icon/ExitFullscreenIcon.md +8 -0
  9. package/docs/icon/FullscreenIcon/FullscreenIcon.md +8 -0
  10. package/docs/icon/FullscreenIcon.md +8 -0
  11. package/docs/icon/InfoIcon/InfoIcon.md +8 -0
  12. package/docs/icon/InfoIcon.md +8 -0
  13. package/docs/icon/MenuIcon/MenuIcon.md +8 -0
  14. package/docs/icon/MenuIcon.md +8 -0
  15. package/docs/icon/RetryIcon/RetryIcon.md +8 -0
  16. package/docs/icon/RetryIcon.md +8 -0
  17. package/docs/icon/RightIcon/RightIcon.md +8 -0
  18. package/docs/icon/RightIcon.md +8 -0
  19. package/docs/icon/SubmitIcon/SubmitIcon.md +8 -0
  20. package/docs/icon/SubmitIcon.md +8 -0
  21. package/docs/icon/SuccessIcon/SuccessIcon.md +8 -0
  22. package/docs/icon/SuccessIcon.md +8 -0
  23. package/docs/icon/UpIcon/UpIcon.md +8 -0
  24. package/docs/icon/UpIcon.md +8 -0
  25. package/docs/icon/WarningIcon/WarningIcon.md +8 -0
  26. package/docs/icon/WarningIcon.md +8 -0
  27. package/docs/index.md +13 -0
  28. package/docs/llms-full.txt +333 -8
  29. package/docs/llms.txt +13 -0
  30. package/docs/ui/DialogCloseButton.md +1 -1
  31. package/docs/ui/Icon.md +2 -2
  32. package/docs/ui/SidebarLayout.md +1 -1
  33. package/docs/ui/TINT_CLASS.md +2 -2
  34. package/docs/ui/Table.md +2 -2
  35. package/icon/AddIcon.d.ts +9 -0
  36. package/icon/AddIcon.js +7 -0
  37. package/icon/CloseIcon.d.ts +9 -0
  38. package/icon/CloseIcon.js +7 -0
  39. package/icon/ErrorIcon.d.ts +9 -0
  40. package/icon/ErrorIcon.js +7 -0
  41. package/icon/ExitFullscreenIcon.d.ts +9 -0
  42. package/icon/ExitFullscreenIcon.js +7 -0
  43. package/icon/FullscreenIcon.d.ts +9 -0
  44. package/icon/FullscreenIcon.js +7 -0
  45. package/icon/InfoIcon.d.ts +9 -0
  46. package/icon/InfoIcon.js +7 -0
  47. package/icon/MenuIcon.d.ts +9 -0
  48. package/icon/MenuIcon.js +7 -0
  49. package/icon/RetryIcon.d.ts +9 -0
  50. package/icon/RetryIcon.js +7 -0
  51. package/icon/RightIcon.d.ts +9 -0
  52. package/icon/RightIcon.js +7 -0
  53. package/icon/SubmitIcon.d.ts +9 -0
  54. package/icon/SubmitIcon.js +7 -0
  55. package/icon/SuccessIcon.d.ts +9 -0
  56. package/icon/SuccessIcon.js +7 -0
  57. package/icon/UpIcon.d.ts +9 -0
  58. package/icon/UpIcon.js +7 -0
  59. package/icon/WarningIcon.d.ts +9 -0
  60. package/icon/WarningIcon.js +7 -0
  61. package/package.json +2 -1
  62. package/ui/block/Blockquote.module.css +1 -1
  63. package/ui/block/Details.js +2 -2
  64. package/ui/block/Details.tsx +2 -2
  65. package/ui/block/Divider.module.css +1 -1
  66. package/ui/button/FullscreenButton.js +3 -2
  67. package/ui/button/FullscreenButton.tsx +3 -2
  68. package/ui/button/RetryButton.js +2 -2
  69. package/ui/button/RetryButton.tsx +2 -2
  70. package/ui/button/SubmitButton.js +2 -2
  71. package/ui/button/SubmitButton.tsx +2 -2
  72. package/ui/dialog/Dialog.js +2 -2
  73. package/ui/dialog/Dialog.tsx +2 -2
  74. package/ui/input/ArrayInput.js +5 -4
  75. package/ui/input/ArrayInput.tsx +5 -4
  76. package/ui/input/DictionaryInput.js +5 -4
  77. package/ui/input/DictionaryInput.tsx +5 -4
  78. package/ui/input/ImageInput.js +2 -2
  79. package/ui/input/ImageInput.tsx +2 -2
  80. package/ui/layout/SidebarLayout.js +3 -2
  81. package/ui/layout/SidebarLayout.md +1 -1
  82. package/ui/layout/SidebarLayout.tsx +3 -2
  83. package/ui/misc/Icon.d.ts +1 -1
  84. package/ui/misc/Icon.js +10 -7
  85. package/ui/misc/Icon.md +1 -1
  86. package/ui/misc/Icon.tsx +10 -7
  87. package/ui/style/TINT_CLASS.md +2 -2
  88. package/ui/table/Table.md +2 -2
  89. package/ui/table/Table.module.css +1 -1
  90. package/ui/tree/TreeBreadcrumbs.js +2 -2
  91. package/ui/tree/TreeBreadcrumbs.tsx +3 -3
@@ -0,0 +1,8 @@
1
+ # AddIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { AddIcon } from "shelving/icon/AddIcon";`
5
+
6
+ Icon to add an item, e.g. the add button on `<ArrayInput>` and `<DictionaryInput>`.
7
+ - Default is the Heroicons `PlusIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/AddIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/AddIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/AddIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [AddIcon](AddIcon/AddIcon.md): Icon to add an item, e.g. the add button on <ArrayInput> and <DictionaryInput>.
@@ -0,0 +1,8 @@
1
+ # CloseIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { CloseIcon } from "shelving/icon/CloseIcon";`
5
+
6
+ Icon to close or remove something, e.g. the close button on `<Dialog>` and the remove buttons on inputs.
7
+ - Default is the Heroicons `XMarkIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/CloseIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/CloseIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/CloseIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [CloseIcon](CloseIcon/CloseIcon.md): Icon to close or remove something, e.g. the close button on <Dialog> and the remove buttons on inputs.
@@ -0,0 +1,8 @@
1
+ # ErrorIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { ErrorIcon } from "shelving/icon/ErrorIcon";`
5
+
6
+ Icon for `status="error"` in `<Icon>`.
7
+ - Default is the Heroicons `XCircleIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/ErrorIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/ErrorIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/ErrorIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [ErrorIcon](ErrorIcon/ErrorIcon.md): Icon for status="error" in <Icon>.
@@ -0,0 +1,8 @@
1
+ # ExitFullscreenIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { ExitFullscreenIcon } from "shelving/icon/ExitFullscreenIcon";`
5
+
6
+ Icon to exit fullscreen, used in `<FullscreenButton>`.
7
+ - Default is the Heroicons `ArrowsPointingInIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/ExitFullscreenIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/ExitFullscreenIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/ExitFullscreenIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [ExitFullscreenIcon](ExitFullscreenIcon/ExitFullscreenIcon.md): Icon to exit fullscreen, used in <FullscreenButton>.
@@ -0,0 +1,8 @@
1
+ # FullscreenIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { FullscreenIcon } from "shelving/icon/FullscreenIcon";`
5
+
6
+ Icon to enter fullscreen, used in `<FullscreenButton>`.
7
+ - Default is the Heroicons `ArrowsPointingOutIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/FullscreenIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/FullscreenIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/FullscreenIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [FullscreenIcon](FullscreenIcon/FullscreenIcon.md): Icon to enter fullscreen, used in <FullscreenButton>.
@@ -0,0 +1,8 @@
1
+ # InfoIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { InfoIcon } from "shelving/icon/InfoIcon";`
5
+
6
+ Icon for `status="info"` (the default) in `<Icon>`.
7
+ - Default is the Heroicons `InformationCircleIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/InfoIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/InfoIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/InfoIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [InfoIcon](InfoIcon/InfoIcon.md): Icon for status="info" (the default) in <Icon>.
@@ -0,0 +1,8 @@
1
+ # MenuIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { MenuIcon } from "shelving/icon/MenuIcon";`
5
+
6
+ Icon to open a menu, e.g. the menu button on `<SidebarLayout>`.
7
+ - Default is the Heroicons `Bars3Icon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/MenuIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/MenuIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/MenuIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [MenuIcon](MenuIcon/MenuIcon.md): Icon to open a menu, e.g. the menu button on <SidebarLayout>.
@@ -0,0 +1,8 @@
1
+ # RetryIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { RetryIcon } from "shelving/icon/RetryIcon";`
5
+
6
+ Icon for `<RetryButton>`.
7
+ - Default is the Heroicons `ArrowPathIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/RetryIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/RetryIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/RetryIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [RetryIcon](RetryIcon/RetryIcon.md): Icon for <RetryButton>.
@@ -0,0 +1,8 @@
1
+ # RightIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { RightIcon } from "shelving/icon/RightIcon";`
5
+
6
+ Chevron that points right, e.g. the separator in `<TreeBreadcrumbs>`.
7
+ - Default is the Heroicons `ChevronRightIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/RightIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/RightIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/RightIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [RightIcon](RightIcon/RightIcon.md): Chevron that points right, e.g. the separator in <TreeBreadcrumbs>.
@@ -0,0 +1,8 @@
1
+ # SubmitIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { SubmitIcon } from "shelving/icon/SubmitIcon";`
5
+
6
+ Icon for the default `<SubmitButton>`.
7
+ - Default is the Heroicons `ArrowRightIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/SubmitIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/SubmitIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/SubmitIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [SubmitIcon](SubmitIcon/SubmitIcon.md): Icon for the default <SubmitButton>.
@@ -0,0 +1,8 @@
1
+ # SuccessIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { SuccessIcon } from "shelving/icon/SuccessIcon";`
5
+
6
+ Icon for `status="success"` in `<Icon>`.
7
+ - Default is the Heroicons `CheckCircleIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/SuccessIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/SuccessIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/SuccessIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [SuccessIcon](SuccessIcon/SuccessIcon.md): Icon for status="success" in <Icon>.
@@ -0,0 +1,8 @@
1
+ # UpIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { UpIcon } from "shelving/icon/UpIcon";`
5
+
6
+ Chevron that points up, e.g. the open and close arrow on `<Details>`.
7
+ - Default is the Heroicons `ChevronUpIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/UpIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/UpIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/UpIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [UpIcon](UpIcon/UpIcon.md): Chevron that points up, e.g. the open and close arrow on <Details>.
@@ -0,0 +1,8 @@
1
+ # WarningIcon
2
+
3
+ - Kind: constant
4
+ - Import: `import { WarningIcon } from "shelving/icon/WarningIcon";`
5
+
6
+ Icon for `status="warning"` and `status="danger"` in `<Icon>`.
7
+ - Default is the Heroicons `ExclamationTriangleIcon`.
8
+ - Swap it for your own icon with a `paths` entry for `shelving/icon/WarningIcon` in your `tsconfig.json`. See `README.md` in this folder.
@@ -0,0 +1,8 @@
1
+ # shelving/icon/WarningIcon
2
+
3
+ - Kind: module
4
+ - Import: `import { … } from "shelving/icon/WarningIcon";`
5
+
6
+ ## Constants
7
+
8
+ - [WarningIcon](WarningIcon/WarningIcon.md): Icon for status="warning" and status="danger" in <Icon>.
package/docs/index.md CHANGED
@@ -49,6 +49,19 @@ See [Releases](https://github.com/dhoulb/shelving/releases) on GitHub.
49
49
  - [shelving/error](error.md): Typed error classes for system and transport failures.
50
50
  - [shelving/extract](extract.md): Turn a folder of source files into a navigable tree of documentation. extract is the engine behind the Shelving documentation site itself.
51
51
  - [shelving/firebase](firebase.md): FirestoreProvider — a Cloud Firestore DBProvider that talks directly to the Firestore REST API using fetch.
52
+ - [shelving/icon/AddIcon](icon/AddIcon.md)
53
+ - [shelving/icon/CloseIcon](icon/CloseIcon.md)
54
+ - [shelving/icon/ErrorIcon](icon/ErrorIcon.md)
55
+ - [shelving/icon/ExitFullscreenIcon](icon/ExitFullscreenIcon.md)
56
+ - [shelving/icon/FullscreenIcon](icon/FullscreenIcon.md)
57
+ - [shelving/icon/InfoIcon](icon/InfoIcon.md)
58
+ - [shelving/icon/MenuIcon](icon/MenuIcon.md)
59
+ - [shelving/icon/RetryIcon](icon/RetryIcon.md)
60
+ - [shelving/icon/RightIcon](icon/RightIcon.md)
61
+ - [shelving/icon/SubmitIcon](icon/SubmitIcon.md)
62
+ - [shelving/icon/SuccessIcon](icon/SuccessIcon.md)
63
+ - [shelving/icon/UpIcon](icon/UpIcon.md)
64
+ - [shelving/icon/WarningIcon](icon/WarningIcon.md)
52
65
  - [shelving/markup](markup.md): A rule-based Markdown renderer that turns user-facing text into React nodes.
53
66
  - [shelving/react](react.md): React hooks and context helpers for integrating Shelving shelving/store, async sequences, and API/DB providers into React components. The module is built on useSyncExternalStore and standard React patterns — no magic, no global state.
54
67
  - [shelving/schema](schema.md): Schema validation for TypeScript. A Schema<T> describes how to coerce and validate an unknown value into a typed T. Schemas are the foundation of shelving — database collections, API endpoints, and form handlers all build on them.