@jcsoftdev/ui 0.3.0 → 0.5.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 +200 -1
- package/README.md +56 -3
- package/bin/ui-theme.mjs +13 -2
- package/dist/atoms/button/button.d.ts +8 -1
- package/dist/atoms/button/button.js +10 -3
- package/dist/atoms/checkbox/checkbox.js +3 -1
- package/dist/atoms/chip/chip.d.ts +11 -3
- package/dist/atoms/chip/chip.js +8 -1
- package/dist/atoms/chip/index.d.ts +1 -1
- package/dist/atoms/chip/index.js +2 -0
- package/dist/atoms/divider/divider.d.ts +15 -0
- package/dist/atoms/divider/divider.js +27 -0
- package/dist/atoms/divider/index.d.ts +1 -0
- package/dist/atoms/divider/index.js +1 -0
- package/dist/atoms/due-chip/due-chip.d.ts +31 -0
- package/dist/atoms/due-chip/due-chip.js +41 -0
- package/dist/atoms/due-chip/index.d.ts +2 -0
- package/dist/atoms/due-chip/index.js +6 -0
- package/dist/atoms/due-chip/model.d.ts +25 -0
- package/dist/atoms/due-chip/model.js +44 -0
- package/dist/atoms/icon-button/icon-button.d.ts +22 -0
- package/dist/atoms/icon-button/icon-button.js +38 -0
- package/dist/atoms/icon-button/index.d.ts +1 -0
- package/dist/atoms/icon-button/index.js +8 -0
- package/dist/atoms/index.d.ts +6 -0
- package/dist/atoms/index.js +6 -0
- package/dist/atoms/internal/hit-area.d.ts +6 -0
- package/dist/atoms/internal/hit-area.js +4 -0
- package/dist/atoms/kbd/index.d.ts +1 -0
- package/dist/atoms/kbd/index.js +4 -0
- package/dist/atoms/kbd/kbd.d.ts +7 -0
- package/dist/atoms/kbd/kbd.js +17 -0
- package/dist/atoms/radio-group/radio-group.js +6 -2
- package/dist/atoms/seal/index.d.ts +1 -0
- package/dist/atoms/seal/index.js +4 -0
- package/dist/atoms/seal/seal.d.ts +30 -0
- package/dist/atoms/seal/seal.js +71 -0
- package/dist/atoms/spinner/index.d.ts +1 -0
- package/dist/atoms/spinner/index.js +5 -0
- package/dist/atoms/spinner/spinner.d.ts +19 -0
- package/dist/atoms/spinner/spinner.js +31 -0
- package/dist/atoms/switch/switch.js +3 -1
- package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
- package/dist/auth/auth-illustration/auth-illustration.js +72 -0
- package/dist/auth/auth-illustration/index.d.ts +3 -0
- package/dist/auth/auth-illustration/index.js +11 -0
- package/dist/auth/auth-illustration/look.d.ts +30 -0
- package/dist/auth/auth-illustration/look.js +0 -0
- package/dist/auth/auth-illustration/model.d.ts +133 -0
- package/dist/auth/auth-illustration/model.js +202 -0
- package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
- package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
- package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
- package/dist/auth/auth-layout/auth-layout.js +190 -0
- package/dist/auth/auth-layout/index.d.ts +1 -0
- package/dist/auth/auth-layout/index.js +1 -0
- package/dist/auth/character/character.d.ts +12 -0
- package/dist/auth/character/character.js +333 -0
- package/dist/auth/character/index.d.ts +1 -0
- package/dist/auth/character/index.js +1 -0
- package/dist/auth/index.d.ts +4 -0
- package/dist/auth/index.js +4 -0
- package/dist/auth/internal/auth-context.d.ts +17 -0
- package/dist/auth/internal/auth-context.js +10 -0
- package/dist/auth/internal/auth-styles.d.ts +1 -0
- package/dist/auth/internal/auth-styles.js +29 -0
- package/dist/auth/internal/portal-glyphs.d.ts +6 -0
- package/dist/auth/internal/portal-glyphs.js +39 -0
- package/dist/auth/login-form/context.d.ts +51 -0
- package/dist/auth/login-form/context.js +12 -0
- package/dist/auth/login-form/index.d.ts +2 -0
- package/dist/auth/login-form/index.js +23 -0
- package/dist/auth/login-form/login-form.d.ts +66 -0
- package/dist/auth/login-form/login-form.js +233 -0
- package/dist/auth/login-form/parts.d.ts +71 -0
- package/dist/auth/login-form/parts.js +371 -0
- package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
- package/dist/auth/looks/auth-illustration-any.js +24 -0
- package/dist/auth/looks/index.d.ts +1 -0
- package/dist/auth/looks/index.js +1 -0
- package/dist/auth/mosaic/index.d.ts +1 -0
- package/dist/auth/mosaic/index.js +1 -0
- package/dist/auth/mosaic/mosaic.d.ts +11 -0
- package/dist/auth/mosaic/mosaic.js +195 -0
- package/dist/auth/slabs/index.d.ts +1 -0
- package/dist/auth/slabs/index.js +1 -0
- package/dist/auth/slabs/slabs.d.ts +13 -0
- package/dist/auth/slabs/slabs.js +136 -0
- package/dist/auth/stack/index.d.ts +1 -0
- package/dist/auth/stack/index.js +1 -0
- package/dist/auth/stack/stack.d.ts +6 -0
- package/dist/auth/stack/stack.js +222 -0
- package/dist/auth/statement/index.d.ts +1 -0
- package/dist/auth/statement/index.js +1 -0
- package/dist/auth/statement/statement.d.ts +13 -0
- package/dist/auth/statement/statement.js +99 -0
- package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
- package/dist/calendar/date-calendar/date-calendar.js +189 -0
- package/dist/calendar/date-calendar/index.d.ts +1 -0
- package/dist/calendar/date-calendar/index.js +6 -0
- package/dist/calendar/index.d.ts +1 -0
- package/dist/calendar/index.js +1 -0
- package/dist/calendar/internal/date-utils.d.ts +26 -0
- package/dist/calendar/internal/date-utils.js +95 -1
- package/dist/containers/aside/aside.d.ts +14 -0
- package/dist/containers/aside/aside.js +25 -0
- package/dist/containers/aside/index.d.ts +1 -0
- package/dist/containers/aside/index.js +5 -0
- package/dist/containers/banner/banner.d.ts +4 -1
- package/dist/containers/banner/banner.js +9 -1
- package/dist/containers/description-list/description-list.d.ts +29 -6
- package/dist/containers/description-list/description-list.js +47 -6
- package/dist/containers/feed/feed.d.ts +23 -0
- package/dist/containers/feed/feed.js +77 -0
- package/dist/containers/feed/index.d.ts +2 -0
- package/dist/containers/feed/index.js +10 -0
- package/dist/containers/feed/model.d.ts +19 -0
- package/dist/containers/feed/model.js +38 -0
- package/dist/containers/index.d.ts +6 -0
- package/dist/containers/index.js +6 -0
- package/dist/containers/kpi/kpi.d.ts +50 -8
- package/dist/containers/kpi/kpi.js +91 -39
- package/dist/containers/list-detail/index.d.ts +1 -0
- package/dist/containers/list-detail/index.js +20 -0
- package/dist/containers/list-detail/list-detail.d.ts +55 -0
- package/dist/containers/list-detail/list-detail.js +221 -0
- package/dist/containers/note/index.d.ts +1 -0
- package/dist/containers/note/index.js +4 -0
- package/dist/containers/note/note.d.ts +13 -0
- package/dist/containers/note/note.js +27 -0
- package/dist/containers/section/index.d.ts +1 -0
- package/dist/containers/section/index.js +6 -0
- package/dist/containers/section/section.d.ts +68 -0
- package/dist/containers/section/section.js +198 -0
- package/dist/containers/shortcuts/index.d.ts +1 -0
- package/dist/containers/shortcuts/index.js +8 -0
- package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
- package/dist/containers/shortcuts/shortcuts.js +50 -0
- package/dist/containers/table/selection.d.ts +9 -0
- package/dist/containers/table/selection.js +20 -0
- package/dist/containers/table/table.d.ts +66 -4
- package/dist/containers/table/table.js +128 -7
- package/dist/containers/timeline/index.d.ts +1 -1
- package/dist/containers/timeline/index.js +4 -2
- package/dist/containers/timeline/timeline.d.ts +32 -5
- package/dist/containers/timeline/timeline.js +154 -90
- package/dist/forms/chip-group/chip-group.d.ts +54 -0
- package/dist/forms/chip-group/chip-group.js +114 -0
- package/dist/forms/chip-group/index.d.ts +1 -0
- package/dist/forms/chip-group/index.js +6 -0
- package/dist/forms/combobox/combobox.d.ts +60 -0
- package/dist/forms/combobox/combobox.js +281 -0
- package/dist/forms/combobox/index.d.ts +1 -0
- package/dist/forms/combobox/index.js +6 -0
- package/dist/forms/date-picker/date-picker.d.ts +40 -0
- package/dist/forms/date-picker/date-picker.js +183 -0
- package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
- package/dist/forms/date-picker/date-time-picker.js +121 -0
- package/dist/forms/date-picker/index.d.ts +2 -0
- package/dist/forms/date-picker/index.js +10 -0
- package/dist/forms/date-picker/model.d.ts +35 -0
- package/dist/forms/date-picker/model.js +83 -0
- package/dist/forms/dropzone/dropzone.d.ts +30 -2
- package/dist/forms/dropzone/dropzone.js +153 -23
- package/dist/forms/field/field.d.ts +16 -10
- package/dist/forms/field/field.js +41 -5
- package/dist/forms/index.d.ts +5 -0
- package/dist/forms/index.js +5 -0
- package/dist/forms/input/index.d.ts +1 -1
- package/dist/forms/input/index.js +4 -1
- package/dist/forms/input/input.d.ts +21 -5
- package/dist/forms/input/input.js +75 -9
- package/dist/forms/input-icon/input-icon.d.ts +1 -1
- package/dist/forms/internal/listbox-items.d.ts +18 -0
- package/dist/forms/internal/listbox-items.js +88 -0
- package/dist/forms/internal/listbox.d.ts +44 -0
- package/dist/forms/internal/listbox.js +74 -0
- package/dist/forms/number-stepper/model.d.ts +16 -0
- package/dist/forms/number-stepper/model.js +23 -0
- package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
- package/dist/forms/number-stepper/number-stepper.js +86 -37
- package/dist/forms/password-input/index.d.ts +1 -0
- package/dist/forms/password-input/index.js +1 -0
- package/dist/forms/password-input/password-input.d.ts +16 -0
- package/dist/forms/password-input/password-input.js +45 -0
- package/dist/forms/select-menu/index.d.ts +1 -0
- package/dist/forms/select-menu/index.js +6 -0
- package/dist/forms/select-menu/select-menu.d.ts +35 -0
- package/dist/forms/select-menu/select-menu.js +230 -0
- package/dist/i18n/strings.d.ts +153 -0
- package/dist/i18n/strings.js +86 -2
- package/dist/i18n/ui-strings-provider.d.ts +1 -1
- package/dist/i18n/ui-strings-provider.js +6 -2
- package/dist/icons/eye.d.ts +2 -0
- package/dist/icons/eye.js +11 -0
- package/dist/icons/graduation-cap.d.ts +2 -0
- package/dist/icons/graduation-cap.js +12 -0
- package/dist/icons/house.d.ts +2 -0
- package/dist/icons/house.js +11 -0
- package/dist/icons/index.d.ts +4 -0
- package/dist/icons/index.js +8 -0
- package/dist/icons/mail.d.ts +2 -0
- package/dist/icons/mail.js +11 -0
- package/dist/navigation/index.d.ts +1 -0
- package/dist/navigation/index.js +1 -0
- package/dist/navigation/stepper/index.d.ts +1 -1
- package/dist/navigation/stepper/index.js +3 -1
- package/dist/navigation/stepper/stepper.d.ts +8 -0
- package/dist/navigation/stepper/stepper.js +68 -45
- package/dist/navigation/tabs/index.d.ts +1 -0
- package/dist/navigation/tabs/index.js +6 -0
- package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
- package/dist/navigation/tabs/tabs-nav.js +57 -0
- package/dist/navigation/wizard/index.d.ts +1 -0
- package/dist/navigation/wizard/index.js +6 -0
- package/dist/navigation/wizard/model.d.ts +33 -0
- package/dist/navigation/wizard/model.js +34 -0
- package/dist/navigation/wizard/wizard.d.ts +45 -0
- package/dist/navigation/wizard/wizard.js +169 -0
- package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
- package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
- package/dist/overlays/alert-dialog/index.d.ts +1 -0
- package/dist/overlays/alert-dialog/index.js +26 -0
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
- package/dist/overlays/dropdown-menu/index.d.ts +1 -1
- package/dist/overlays/dropdown-menu/index.js +8 -2
- package/dist/overlays/index.d.ts +2 -0
- package/dist/overlays/index.js +2 -0
- package/dist/overlays/testing/index.d.ts +5 -0
- package/dist/overlays/testing/index.js +4 -0
- package/dist/overlays/toaster/index.d.ts +2 -1
- package/dist/overlays/toaster/index.js +4 -2
- package/dist/overlays/toaster/toast-store.d.ts +6 -2
- package/dist/overlays/toaster/toast.d.ts +3 -0
- package/dist/overlays/toaster/toast.js +3 -0
- package/dist/overlays/toaster/toaster.d.ts +3 -0
- package/dist/overlays/toaster/toaster.js +36 -3
- package/dist/overlays/tooltip/index.d.ts +1 -0
- package/dist/overlays/tooltip/index.js +4 -0
- package/dist/overlays/tooltip/model.d.ts +10 -0
- package/dist/overlays/tooltip/model.js +13 -0
- package/dist/overlays/tooltip/tooltip.d.ts +41 -0
- package/dist/overlays/tooltip/tooltip.js +116 -0
- package/dist/primitives/use-dismissable-layer.js +1 -1
- package/dist/states/error-state/error-state.d.ts +6 -1
- package/dist/states/error-state/error-state.js +13 -9
- package/dist/states/skeleton/skeleton.d.ts +8 -2
- package/dist/states/skeleton/skeleton.js +44 -2
- package/icons/svg/eye.svg +4 -0
- package/icons/svg/graduation-cap.svg +5 -0
- package/icons/svg/house.svg +4 -0
- package/icons/svg/mail.svg +4 -0
- package/package.json +2 -2
- package/scripts/build-theme.mjs +12 -1
- package/src/atoms/button/button.tsx +25 -3
- package/src/atoms/checkbox/checkbox.tsx +3 -1
- package/src/atoms/chip/chip.tsx +18 -3
- package/src/atoms/chip/index.ts +2 -0
- package/src/atoms/divider/divider.tsx +40 -0
- package/src/atoms/divider/index.ts +1 -0
- package/src/atoms/due-chip/due-chip.tsx +75 -0
- package/src/atoms/due-chip/index.ts +2 -0
- package/src/atoms/due-chip/model.ts +67 -0
- package/src/atoms/icon-button/icon-button.tsx +58 -0
- package/src/atoms/icon-button/index.ts +6 -0
- package/src/atoms/index.ts +6 -0
- package/src/atoms/internal/hit-area.ts +7 -0
- package/src/atoms/kbd/index.ts +1 -0
- package/src/atoms/kbd/kbd.tsx +20 -0
- package/src/atoms/radio-group/radio-group.tsx +8 -2
- package/src/atoms/seal/index.ts +1 -0
- package/src/atoms/seal/seal.tsx +107 -0
- package/src/atoms/spinner/index.ts +1 -0
- package/src/atoms/spinner/spinner.tsx +49 -0
- package/src/atoms/switch/switch.tsx +3 -1
- package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
- package/src/auth/auth-illustration/index.ts +8 -0
- package/src/auth/auth-illustration/look.ts +32 -0
- package/src/auth/auth-illustration/model.ts +330 -0
- package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
- package/src/auth/auth-layout/auth-layout.tsx +282 -0
- package/src/auth/auth-layout/index.ts +1 -0
- package/src/auth/character/character.tsx +346 -0
- package/src/auth/character/index.ts +1 -0
- package/src/auth/index.ts +4 -0
- package/src/auth/internal/auth-context.ts +26 -0
- package/src/auth/internal/auth-styles.tsx +39 -0
- package/src/auth/internal/portal-glyphs.tsx +32 -0
- package/src/auth/login-form/context.ts +78 -0
- package/src/auth/login-form/index.ts +21 -0
- package/src/auth/login-form/login-form.tsx +330 -0
- package/src/auth/login-form/parts.tsx +457 -0
- package/src/auth/looks/auth-illustration-any.tsx +38 -0
- package/src/auth/looks/index.ts +1 -0
- package/src/auth/mosaic/index.ts +1 -0
- package/src/auth/mosaic/mosaic.tsx +255 -0
- package/src/auth/slabs/index.ts +1 -0
- package/src/auth/slabs/slabs.tsx +181 -0
- package/src/auth/stack/index.ts +1 -0
- package/src/auth/stack/stack.tsx +267 -0
- package/src/auth/statement/index.ts +1 -0
- package/src/auth/statement/statement.tsx +122 -0
- package/src/calendar/date-calendar/date-calendar.tsx +230 -0
- package/src/calendar/date-calendar/index.ts +5 -0
- package/src/calendar/index.ts +1 -0
- package/src/calendar/internal/date-utils.ts +115 -0
- package/src/containers/aside/aside.tsx +40 -0
- package/src/containers/aside/index.ts +1 -0
- package/src/containers/banner/banner.tsx +18 -1
- package/src/containers/description-list/description-list.tsx +85 -9
- package/src/containers/feed/feed.tsx +99 -0
- package/src/containers/feed/index.ts +8 -0
- package/src/containers/feed/model.ts +54 -0
- package/src/containers/index.ts +6 -0
- package/src/containers/kpi/kpi.tsx +161 -62
- package/src/containers/list-detail/index.ts +15 -0
- package/src/containers/list-detail/list-detail.tsx +293 -0
- package/src/containers/note/index.ts +1 -0
- package/src/containers/note/note.tsx +38 -0
- package/src/containers/section/index.ts +11 -0
- package/src/containers/section/section.tsx +281 -0
- package/src/containers/shortcuts/index.ts +6 -0
- package/src/containers/shortcuts/shortcuts.tsx +92 -0
- package/src/containers/table/selection.ts +26 -0
- package/src/containers/table/table.tsx +215 -13
- package/src/containers/timeline/index.ts +3 -0
- package/src/containers/timeline/timeline.tsx +204 -93
- package/src/forms/chip-group/chip-group.tsx +184 -0
- package/src/forms/chip-group/index.ts +8 -0
- package/src/forms/combobox/combobox.tsx +359 -0
- package/src/forms/combobox/index.ts +7 -0
- package/src/forms/date-picker/date-picker.tsx +239 -0
- package/src/forms/date-picker/date-time-picker.tsx +178 -0
- package/src/forms/date-picker/index.ts +10 -0
- package/src/forms/date-picker/model.ts +108 -0
- package/src/forms/dropzone/dropzone.tsx +217 -35
- package/src/forms/field/field.tsx +72 -7
- package/src/forms/index.ts +5 -0
- package/src/forms/input/index.ts +8 -1
- package/src/forms/input/input.tsx +99 -12
- package/src/forms/input-icon/input-icon.tsx +1 -1
- package/src/forms/internal/listbox-items.tsx +103 -0
- package/src/forms/internal/listbox.ts +124 -0
- package/src/forms/number-stepper/model.ts +35 -0
- package/src/forms/number-stepper/number-stepper.tsx +132 -42
- package/src/forms/password-input/index.ts +1 -0
- package/src/forms/password-input/password-input.tsx +57 -0
- package/src/forms/select-menu/index.ts +7 -0
- package/src/forms/select-menu/select-menu.tsx +280 -0
- package/src/i18n/strings.ts +153 -0
- package/src/i18n/ui-strings-provider.tsx +15 -4
- package/src/icons/eye.tsx +12 -0
- package/src/icons/graduation-cap.tsx +13 -0
- package/src/icons/house.tsx +12 -0
- package/src/icons/index.ts +4 -0
- package/src/icons/mail.tsx +12 -0
- package/src/navigation/index.ts +1 -0
- package/src/navigation/stepper/index.ts +7 -1
- package/src/navigation/stepper/stepper.tsx +41 -5
- package/src/navigation/tabs/index.ts +7 -0
- package/src/navigation/tabs/tabs-nav.tsx +131 -0
- package/src/navigation/wizard/index.ts +7 -0
- package/src/navigation/wizard/model.ts +61 -0
- package/src/navigation/wizard/wizard.tsx +222 -0
- package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
- package/src/overlays/alert-dialog/index.ts +19 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
- package/src/overlays/dropdown-menu/index.ts +3 -0
- package/src/overlays/index.ts +2 -0
- package/src/overlays/testing/index.ts +5 -0
- package/src/overlays/toaster/index.ts +2 -0
- package/src/overlays/toaster/toast-store.ts +6 -2
- package/src/overlays/toaster/toast.ts +6 -0
- package/src/overlays/toaster/toaster.tsx +44 -2
- package/src/overlays/tooltip/index.ts +1 -0
- package/src/overlays/tooltip/model.ts +18 -0
- package/src/overlays/tooltip/tooltip.tsx +166 -0
- package/src/primitives/use-dismissable-layer.ts +7 -2
- package/src/states/error-state/error-state.tsx +19 -8
- package/src/states/skeleton/skeleton.tsx +68 -2
- package/styles/tailwind.css +33 -30
- package/styles/theme.css +33 -30
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
Children,
|
|
5
|
+
type ComponentPropsWithoutRef,
|
|
6
|
+
createContext,
|
|
7
|
+
isValidElement,
|
|
8
|
+
type ReactNode,
|
|
9
|
+
useContext,
|
|
10
|
+
useEffect,
|
|
11
|
+
useId,
|
|
12
|
+
useState,
|
|
13
|
+
} from "react";
|
|
14
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
15
|
+
import { cn } from "../../utils/cn.js";
|
|
16
|
+
|
|
17
|
+
/** Heading depth: how many titled sections enclose this point. A titleless wrapper adds nothing. */
|
|
18
|
+
const SectionDepth = createContext(0);
|
|
19
|
+
|
|
20
|
+
interface SectionParts {
|
|
21
|
+
depth: number;
|
|
22
|
+
titleId: string;
|
|
23
|
+
classNames: ClassNames<SectionPart> | undefined;
|
|
24
|
+
padded: boolean;
|
|
25
|
+
registerTitle: (present: boolean) => void;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const SectionPartsContext = createContext<SectionParts | null>(null);
|
|
29
|
+
|
|
30
|
+
function useSectionParts(part: string): SectionParts {
|
|
31
|
+
const parts = useContext(SectionPartsContext);
|
|
32
|
+
if (!parts) throw new Error(`Section.${part} must be rendered inside a Section`);
|
|
33
|
+
return parts;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
type SectionHeadingTag = "h2" | "h3" | "h4" | "h5" | "h6";
|
|
37
|
+
const headingForDepth: SectionHeadingTag[] = ["h2", "h3", "h4", "h5", "h6"];
|
|
38
|
+
|
|
39
|
+
export type SectionPart =
|
|
40
|
+
| "root"
|
|
41
|
+
| "header"
|
|
42
|
+
| "heading"
|
|
43
|
+
| "title"
|
|
44
|
+
| "count"
|
|
45
|
+
| "description"
|
|
46
|
+
| "actions"
|
|
47
|
+
| "body";
|
|
48
|
+
|
|
49
|
+
export interface SectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
|
|
50
|
+
as?: "section" | "div" | "article";
|
|
51
|
+
title?: ReactNode;
|
|
52
|
+
/** Outlined count next to the title (a record total, say). */
|
|
53
|
+
count?: ReactNode;
|
|
54
|
+
description?: ReactNode;
|
|
55
|
+
/** Slot at the end of the header row; takes the full row under 560px of the section's own width. */
|
|
56
|
+
actions?: ReactNode;
|
|
57
|
+
/** Heading element of the title. Defaults to `h2`, one level deeper per nested section. */
|
|
58
|
+
titleAs?: SectionHeadingTag;
|
|
59
|
+
/** Hairline above the section. */
|
|
60
|
+
divider?: boolean;
|
|
61
|
+
/** Vertical padding around the body. Defaults to `true`; `false` leaves the body edge to edge. */
|
|
62
|
+
padded?: boolean;
|
|
63
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
|
|
64
|
+
classNames?: ClassNames<SectionPart>;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function isPart(node: ReactNode): boolean {
|
|
68
|
+
return (
|
|
69
|
+
isValidElement(node) &&
|
|
70
|
+
[
|
|
71
|
+
SectionHeader,
|
|
72
|
+
SectionTitle,
|
|
73
|
+
SectionCount,
|
|
74
|
+
SectionDescription,
|
|
75
|
+
SectionActions,
|
|
76
|
+
SectionBody,
|
|
77
|
+
].includes(node.type as never)
|
|
78
|
+
);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const ignoreTitle = () => {};
|
|
82
|
+
|
|
83
|
+
function hasTitlePart(nodes: ReactNode): boolean {
|
|
84
|
+
return Children.toArray(nodes).some((node) => {
|
|
85
|
+
if (!isValidElement<{ children?: ReactNode }>(node)) return false;
|
|
86
|
+
if (node.type === SectionTitle) return true;
|
|
87
|
+
return node.type === SectionHeader && hasTitlePart(node.props.children);
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* A titled block of a page: a header row (title, count, description, actions) and a body.
|
|
93
|
+
* It never pads the inline edges (the page layout owns the gutter), and sections nest without
|
|
94
|
+
* stacking: each titled level steps its heading down and its vertical spacing tighter, while a
|
|
95
|
+
* titleless wrapper takes no level at all. Named by its title when it has one.
|
|
96
|
+
*
|
|
97
|
+
* Two ways to fill it, which mix: the props (`title`, `count`, `description`, `actions`, with the
|
|
98
|
+
* children as the body) or the parts `Section.Header`, `Section.Title`, `Section.Count`,
|
|
99
|
+
* `Section.Description`, `Section.Actions` and `Section.Body`. As soon as a part is a direct
|
|
100
|
+
* child, the children are rendered as written and the body is wherever you place `Section.Body`.
|
|
101
|
+
*/
|
|
102
|
+
export function Section({
|
|
103
|
+
as = "section",
|
|
104
|
+
title,
|
|
105
|
+
count,
|
|
106
|
+
description,
|
|
107
|
+
actions,
|
|
108
|
+
titleAs,
|
|
109
|
+
divider = false,
|
|
110
|
+
padded = true,
|
|
111
|
+
className,
|
|
112
|
+
classNames,
|
|
113
|
+
children,
|
|
114
|
+
...props
|
|
115
|
+
}: SectionProps) {
|
|
116
|
+
const outerDepth = useContext(SectionDepth);
|
|
117
|
+
const titleId = useId();
|
|
118
|
+
const [registered, setRegistered] = useState(false);
|
|
119
|
+
const Tag = as;
|
|
120
|
+
const composed = Children.toArray(children).some(isPart);
|
|
121
|
+
const hasTitle = title !== undefined || (composed && (registered || hasTitlePart(children)));
|
|
122
|
+
const hasHeader =
|
|
123
|
+
title !== undefined ||
|
|
124
|
+
count !== undefined ||
|
|
125
|
+
description !== undefined ||
|
|
126
|
+
actions !== undefined;
|
|
127
|
+
const named = hasTitle && as !== "div";
|
|
128
|
+
|
|
129
|
+
return (
|
|
130
|
+
<SectionDepth.Provider value={outerDepth + (hasTitle ? 1 : 0)}>
|
|
131
|
+
<SectionPartsContext.Provider
|
|
132
|
+
value={{
|
|
133
|
+
depth: outerDepth,
|
|
134
|
+
titleId,
|
|
135
|
+
classNames,
|
|
136
|
+
padded,
|
|
137
|
+
registerTitle: composed ? setRegistered : ignoreTitle,
|
|
138
|
+
}}
|
|
139
|
+
>
|
|
140
|
+
<Tag
|
|
141
|
+
{...props}
|
|
142
|
+
data-depth={outerDepth}
|
|
143
|
+
aria-labelledby={named && props["aria-label"] === undefined ? titleId : undefined}
|
|
144
|
+
className={cn(
|
|
145
|
+
"@container/section min-w-0",
|
|
146
|
+
divider && "border-t-divider",
|
|
147
|
+
classNames?.root,
|
|
148
|
+
className,
|
|
149
|
+
)}
|
|
150
|
+
>
|
|
151
|
+
{hasHeader ? (
|
|
152
|
+
<SectionHeader>
|
|
153
|
+
{title !== undefined ? <SectionTitle as={titleAs}>{title}</SectionTitle> : null}
|
|
154
|
+
{count !== undefined ? <SectionCount>{count}</SectionCount> : null}
|
|
155
|
+
{description !== undefined ? (
|
|
156
|
+
<SectionDescription>{description}</SectionDescription>
|
|
157
|
+
) : null}
|
|
158
|
+
{actions !== undefined ? <SectionActions>{actions}</SectionActions> : null}
|
|
159
|
+
</SectionHeader>
|
|
160
|
+
) : null}
|
|
161
|
+
{composed ? children : <SectionBody>{children}</SectionBody>}
|
|
162
|
+
</Tag>
|
|
163
|
+
</SectionPartsContext.Provider>
|
|
164
|
+
</SectionDepth.Provider>
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
export interface SectionHeaderProps extends ComponentPropsWithoutRef<"div"> {}
|
|
169
|
+
|
|
170
|
+
/** Header row of a composed `Section`: title, count and description wrap, actions go to the end. */
|
|
171
|
+
export function SectionHeader({ className, ...props }: SectionHeaderProps) {
|
|
172
|
+
const { depth, classNames } = useSectionParts("Header");
|
|
173
|
+
return (
|
|
174
|
+
<div
|
|
175
|
+
{...props}
|
|
176
|
+
className={cn(
|
|
177
|
+
"flex flex-wrap items-center gap-x-2.5 gap-y-1.5",
|
|
178
|
+
depth > 0 ? "pt-2 pb-1.5" : "pt-3.5 pb-2.5",
|
|
179
|
+
classNames?.header,
|
|
180
|
+
className,
|
|
181
|
+
)}
|
|
182
|
+
/>
|
|
183
|
+
);
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
export interface SectionTitleProps extends ComponentPropsWithoutRef<"h2"> {
|
|
187
|
+
/** Heading element. Defaults to `h2`, one level deeper per enclosing titled section. */
|
|
188
|
+
as?: SectionHeadingTag | undefined;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Heading of a composed `Section`; it names the section and takes the level its depth implies. */
|
|
192
|
+
export function SectionTitle({ as, className, ...props }: SectionTitleProps) {
|
|
193
|
+
const { depth, titleId, classNames, registerTitle } = useSectionParts("Title");
|
|
194
|
+
useEffect(() => {
|
|
195
|
+
registerTitle(true);
|
|
196
|
+
return () => registerTitle(false);
|
|
197
|
+
}, [registerTitle]);
|
|
198
|
+
const Heading = as ?? headingForDepth[Math.min(depth, headingForDepth.length - 1)] ?? "h2";
|
|
199
|
+
return (
|
|
200
|
+
<Heading
|
|
201
|
+
id={titleId}
|
|
202
|
+
{...props}
|
|
203
|
+
className={cn(
|
|
204
|
+
"m-0 min-w-0 font-semibold text-ink",
|
|
205
|
+
depth > 0 ? "text-control" : "text-body",
|
|
206
|
+
classNames?.title,
|
|
207
|
+
classNames?.heading,
|
|
208
|
+
className,
|
|
209
|
+
)}
|
|
210
|
+
/>
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
export interface SectionCountProps extends ComponentPropsWithoutRef<"span"> {}
|
|
215
|
+
|
|
216
|
+
/** Outlined count next to the title. */
|
|
217
|
+
export function SectionCount({ className, ...props }: SectionCountProps) {
|
|
218
|
+
const { classNames } = useSectionParts("Count");
|
|
219
|
+
return (
|
|
220
|
+
<span
|
|
221
|
+
{...props}
|
|
222
|
+
className={cn(
|
|
223
|
+
"rounded-pill border-divider px-1.75 text-count text-ink-3 tabular-nums",
|
|
224
|
+
classNames?.count,
|
|
225
|
+
className,
|
|
226
|
+
)}
|
|
227
|
+
/>
|
|
228
|
+
);
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
export interface SectionDescriptionProps extends ComponentPropsWithoutRef<"p"> {}
|
|
232
|
+
|
|
233
|
+
export function SectionDescription({ className, ...props }: SectionDescriptionProps) {
|
|
234
|
+
const { classNames } = useSectionParts("Description");
|
|
235
|
+
return (
|
|
236
|
+
<p
|
|
237
|
+
{...props}
|
|
238
|
+
className={cn("m-0 min-w-0 text-meta text-ink-3", classNames?.description, className)}
|
|
239
|
+
/>
|
|
240
|
+
);
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
export interface SectionActionsProps extends ComponentPropsWithoutRef<"div"> {}
|
|
244
|
+
|
|
245
|
+
/** Slot at the end of the header; takes the full row under 560px of the section's own width. */
|
|
246
|
+
export function SectionActions({ className, ...props }: SectionActionsProps) {
|
|
247
|
+
const { classNames } = useSectionParts("Actions");
|
|
248
|
+
return (
|
|
249
|
+
<div
|
|
250
|
+
{...props}
|
|
251
|
+
className={cn(
|
|
252
|
+
"ml-auto flex flex-wrap items-center gap-2 @max-[560px]/section:ml-0 @max-[560px]/section:w-full",
|
|
253
|
+
classNames?.actions,
|
|
254
|
+
className,
|
|
255
|
+
)}
|
|
256
|
+
/>
|
|
257
|
+
);
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
export interface SectionBodyProps extends ComponentPropsWithoutRef<"div"> {
|
|
261
|
+
/** Vertical padding. Defaults to the section's `padded`. */
|
|
262
|
+
padded?: boolean | undefined;
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
export function SectionBody({ padded, className, ...props }: SectionBodyProps) {
|
|
266
|
+
const { depth, classNames, padded: rootPadded } = useSectionParts("Body");
|
|
267
|
+
const pad = padded ?? rootPadded;
|
|
268
|
+
return (
|
|
269
|
+
<div
|
|
270
|
+
{...props}
|
|
271
|
+
className={cn("min-w-0", pad && (depth > 0 ? "py-2" : "py-4"), classNames?.body, className)}
|
|
272
|
+
/>
|
|
273
|
+
);
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
Section.Header = SectionHeader;
|
|
277
|
+
Section.Title = SectionTitle;
|
|
278
|
+
Section.Count = SectionCount;
|
|
279
|
+
Section.Description = SectionDescription;
|
|
280
|
+
Section.Actions = SectionActions;
|
|
281
|
+
Section.Body = SectionBody;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type ComponentPropsWithoutRef,
|
|
3
|
+
cloneElement,
|
|
4
|
+
isValidElement,
|
|
5
|
+
type ReactElement,
|
|
6
|
+
type ReactNode,
|
|
7
|
+
} from "react";
|
|
8
|
+
import { Kbd } from "../../atoms/kbd/kbd.js";
|
|
9
|
+
import { cn } from "../../utils/cn.js";
|
|
10
|
+
import { Slot } from "../../utils/slot.js";
|
|
11
|
+
|
|
12
|
+
export type ShortcutsProps = ComponentPropsWithoutRef<"ul">;
|
|
13
|
+
|
|
14
|
+
/** A short list of quick links or actions, flush to its container. Items go in `ShortcutsItem`. */
|
|
15
|
+
export function Shortcuts({ className, ...props }: ShortcutsProps) {
|
|
16
|
+
return <ul className={cn("m-0 flex list-none flex-col gap-0.5 p-0", className)} {...props} />;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface ShortcutsItemProps extends ComponentPropsWithoutRef<"a"> {
|
|
20
|
+
/** Decorative glyph before the label. */
|
|
21
|
+
icon?: ReactNode;
|
|
22
|
+
/** Keyboard hint at the end (`G P`, `⌘K`). */
|
|
23
|
+
kbd?: string;
|
|
24
|
+
/** Count or badge at the end. */
|
|
25
|
+
count?: ReactNode;
|
|
26
|
+
/**
|
|
27
|
+
* Renders the single child element (a router `Link`, say) with the item's look instead of an
|
|
28
|
+
* anchor. Without `href` and without `asChild` the item is a `<button>`.
|
|
29
|
+
*/
|
|
30
|
+
asChild?: boolean;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
const itemClasses =
|
|
34
|
+
"flex min-h-control-sm w-full cursor-pointer items-center gap-2 rounded-button px-2 text-start text-fs-130 text-ink-2 no-underline hover:bg-surface-2 hover:text-ink focus-visible:focus-ring in-data-[density=touch]:min-h-11";
|
|
35
|
+
|
|
36
|
+
export function ShortcutsItem({
|
|
37
|
+
icon,
|
|
38
|
+
kbd,
|
|
39
|
+
count,
|
|
40
|
+
asChild = false,
|
|
41
|
+
href,
|
|
42
|
+
className,
|
|
43
|
+
children,
|
|
44
|
+
...props
|
|
45
|
+
}: ShortcutsItemProps) {
|
|
46
|
+
const content = (label: ReactNode) => (
|
|
47
|
+
<>
|
|
48
|
+
{icon !== undefined ? (
|
|
49
|
+
<span aria-hidden="true" className="inline-flex shrink-0 text-ink-3 [&_svg]:size-4">
|
|
50
|
+
{icon}
|
|
51
|
+
</span>
|
|
52
|
+
) : null}
|
|
53
|
+
<span className="min-w-0 flex-1 truncate">{label}</span>
|
|
54
|
+
{count !== undefined ? (
|
|
55
|
+
<span className="text-count text-ink-3 tabular-nums">{count}</span>
|
|
56
|
+
) : null}
|
|
57
|
+
{kbd !== undefined ? <Kbd>{kbd}</Kbd> : null}
|
|
58
|
+
</>
|
|
59
|
+
);
|
|
60
|
+
const classes = cn(itemClasses, className);
|
|
61
|
+
|
|
62
|
+
if (asChild && isValidElement(children)) {
|
|
63
|
+
const child = children as ReactElement<{ children?: ReactNode }>;
|
|
64
|
+
return (
|
|
65
|
+
<li>
|
|
66
|
+
<Slot className={classes} {...props}>
|
|
67
|
+
{cloneElement(child, undefined, content(child.props.children))}
|
|
68
|
+
</Slot>
|
|
69
|
+
</li>
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
if (href === undefined && !asChild) {
|
|
73
|
+
return (
|
|
74
|
+
<li>
|
|
75
|
+
<button
|
|
76
|
+
type="button"
|
|
77
|
+
className={classes}
|
|
78
|
+
{...(props as unknown as ComponentPropsWithoutRef<"button">)}
|
|
79
|
+
>
|
|
80
|
+
{content(children)}
|
|
81
|
+
</button>
|
|
82
|
+
</li>
|
|
83
|
+
);
|
|
84
|
+
}
|
|
85
|
+
return (
|
|
86
|
+
<li>
|
|
87
|
+
<a href={href} className={classes} {...props}>
|
|
88
|
+
{content(children)}
|
|
89
|
+
</a>
|
|
90
|
+
</li>
|
|
91
|
+
);
|
|
92
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export type SelectAllState = boolean | "indeterminate";
|
|
2
|
+
|
|
3
|
+
/** Adds the key when absent, removes it when present. Order of the other keys is kept. */
|
|
4
|
+
export function toggleKey(keys: readonly string[], key: string): string[] {
|
|
5
|
+
return keys.includes(key) ? keys.filter((current) => current !== key) : [...keys, key];
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
/** Adds (`on`) or removes (`!on`) many keys at once, without duplicates. */
|
|
9
|
+
export function setKeys(keys: readonly string[], many: readonly string[], on: boolean): string[] {
|
|
10
|
+
return on ? [...new Set([...keys, ...many])] : keys.filter((current) => !many.includes(current));
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/** `true` when every visible key is selected, `"indeterminate"` when only some are, else `false`. */
|
|
14
|
+
export function selectAllState(
|
|
15
|
+
keys: readonly string[],
|
|
16
|
+
visible: readonly string[],
|
|
17
|
+
): SelectAllState {
|
|
18
|
+
const count = visible.filter((key) => keys.includes(key)).length;
|
|
19
|
+
if (visible.length > 0 && count === visible.length) return true;
|
|
20
|
+
return count > 0 ? "indeterminate" : false;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Fills `{row}` in a "Select {row}" template. */
|
|
24
|
+
export function formatSelectRow(template: string, row: string): string {
|
|
25
|
+
return template.replace("{row}", row).trim();
|
|
26
|
+
}
|