@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/components/index.d.ts

@@ -0,0 +1,226 @@
+export { default as Spinner } from "./Spinner";
+export { default as Button } from "./Button";
+export { default as Field } from "./Field";
+/**
+ * FieldError — the message renderer `Field` uses, exported standalone
+ * (capability gap G-18).
+ *
+ * Charter R-4.1 MUST requires a field error to carry an ICON; `Field` rendered a
+ * bare red helper text without one, so the canonical field wrapper missed a MUST
+ * on every form of every module. And a LIST-level error (a Formik array, an
+ * upload slot) has no single control to wrap in a `Field` at all — addpe-fe's
+ * local `InlineFieldAlert` reimplemented the recipe and was, ironically, more
+ * charter-compliant than the shared component it could not reuse.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as FieldError } from "./FieldError";
+export type { FieldErrorProps } from "./FieldError";
+export { default as Input } from "./Input";
+export { default as Select } from "./Select";
+export type { SelectOption, SelectOptionObject, SelectOptionValue, SelectValue, SelectChangeLike, SelectLabels } from "./Select";
+export { default as Textarea } from "./Textarea";
+export { default as Checkbox, CheckboxGroup } from "./Checkbox";
+export { default as Radio, RadioGroup } from "./Radio";
+export { default as Switch } from "./Switch";
+export { default as Combobox } from "./Combobox";
+export type { ComboboxOption, ComboboxOptionValue, ComboboxValue, ComboboxLabels, ComboboxProps } from "./Combobox";
+export { default as TelInput } from "./TelInput";
+export { default as NumberInput, FR_DECIMAL_SEPARATOR, FR_THOUSAND_SEPARATOR, } from "./NumberInput";
+export { default as DatePicker, DATE_FORMAT_CHARTER, } from "./DatePicker";
+export { default as DateTimePicker, DATETIME_FORMAT_CHARTER, } from "./DateTimePicker";
+export { default as TimePicker, TIME_FORMAT_CHARTER, } from "./TimePicker";
+export { default as DateRangePicker } from "./DateRangePicker";
+export { default as Status } from "./Status";
+/**
+ * Status contracts — public typed surface (capability gap G-31).
+ *
+ * Same defect as the `StepStatus` and `FieldHelp` blocks below: `Status` was
+ * exported as a VALUE while the types describing it were not re-exported here,
+ * so a host mapping its own business codes onto the six canonical workflow
+ * tones had to hand-write the union at the call site — which the Platform
+ * TypeScript Guidelines forbid ("Reusable types belong inside Shared UI
+ * Library … Never duplicate"). caution-ui carried exactly that local twin
+ * (`CautionStatusKind`, six members, structurally identical) plus five
+ * `as ComponentProps<typeof Status>` assertions at the render sites — casts
+ * that were never needed for anything except reaching an unreachable type.
+ *
+ * `StatusProps` travels with it: a consumer building the chip props as an
+ * object (mobile card, KV value slot, DataGrid cell renderer) needs the prop
+ * contract, and re-declaring it is the same duplication one level down.
+ *
+ * KNOWN DEBT: `StatusKind` is currently derived as
+ * `keyof typeof STATUS_LABELS_FR`, and STATUS_LABELS_FR is itself marked
+ * `@deprecated … Will be removed in v0.3` (we are at 0.8.0). Deleting that
+ * const would delete the public type with it. Re-anchoring `StatusKind` to a
+ * literal tuple form of STATUS_KEYS — which is typed `readonly string[]` and
+ * so cannot currently derive a union — is tracked separately; surfacing the
+ * type now does not deepen that debt, it only makes it visible to consumers.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to
+ * ./v2/index.ts, which is a retiring surface. Reachable as
+ * `import type { StatusKind } from "@portnet/ui"` via the root star-export.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+export type { StatusKind, StatusProps } from "./Status";
+export { default as Chip } from "./Chip";
+export { default as Skeleton, SkeletonKPI, SkeletonRow, SkeletonDetailHero, SkeletonTabContent, SkeletonText, } from "./Skeleton";
+export { default as Modal } from "./Modal";
+export { default as Drawer } from "./Drawer";
+export type { DrawerProps, DrawerLabels, DrawerAnchor } from "./Drawer";
+export { default as ConfirmDialog } from "./ConfirmDialog";
+export { default as Tabs } from "./Tabs";
+export { default as HStepper, VStepper } from "./Stepper";
+/**
+ * Stepper data contracts — public typed surface.
+ *
+ * `StepStatus` is the literal union `HStepper`/`VStepper` accept on each
+ * step. It was exported from ./Stepper but never re-exported here, so a host
+ * building a step array had to hand-write the union at the call site — which
+ * the Platform TypeScript Guidelines forbid ("Reusable types belong inside
+ * Shared UI Library … Never duplicate"). ms_licenceexportation's
+ * ExportationDetailProgress carried exactly that duplicate, with a comment
+ * recording why. `VStepperItem` is surfaced alongside it because the same
+ * consumer constructs the item objects the union lives in.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts: not added to
+ * ./v2/index.ts, which is a retiring surface. Reachable as
+ * `import type { StepStatus } from "@portnet/ui"` via the root star-export.
+ *
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+export type { StepStatus, StepState, VStepperItem } from "./Stepper";
+export { default as FilterTab } from "./FilterTab";
+export type { FilterTabVariant, FilterTabLabels } from "./FilterTab";
+export { default as EmptyState } from "./EmptyState";
+export { default as Banner } from "./Banner";
+export type { BannerVariant, BannerAction } from "./Banner";
+/**
+ * SectionErrorBoundary — fault tolerance by import, not by copy (gap G-30).
+ *
+ * ISO/IEC 25010 § Reliability requires a system to keep operating despite a
+ * fault; React unmounts the WHOLE tree on a render exception, so one failing
+ * section replaces the page with a blank screen. `ms-ti-fe` wrapped 13 sections
+ * in a boundary of its own while `addpe-fe` and this library had none — a
+ * platform guarantee living as one module's private safeguard.
+ *
+ * Declared after Banner because it renders one as its fallback.
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as SectionErrorBoundary } from "./SectionErrorBoundary";
+export type { SectionErrorBoundaryProps } from "./SectionErrorBoundary";
+export { default as ToastProvider, useToast } from "./Toast";
+export type { ToastVariant, ToastProviderLabels, ToastUndoOptions, ToastProgressHandle, ToastApi } from "./Toast";
+export { default as KV } from "./KV";
+export { default as KPICard } from "./KPICard";
+export type { KPICardProps, KPICardLabels } from "./KPICard";
+/**
+ * KPIStrip — the metric-tile row (capability gap G-11).
+ *
+ * Charter §07 names this zone in the canonical page template (« ③ FILTERS / KPI
+ * STRIP ») but the library shipped only the TILE. So every screen wrote the
+ * grid, and the two in addpe-fe disagree on the desktop ladder — a KPI row that
+ * reflows differently per screen for no reason a user could name.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as KPIStrip } from "./KPIStrip";
+export type { KPIStripProps } from "./KPIStrip";
+export { default as MobileRowCard } from "./MobileRowCard";
+export type { MobileRowCardProps } from "./MobileRowCard";
+export { default as OverflowMenu } from "./OverflowMenu";
+export type { OverflowMenuAction, OverflowMenuProps, OverflowMenuLabels } from "./OverflowMenu";
+export { default as FieldHelp } from "./FieldHelp";
+/**
+ * FieldHelp contracts — public typed surface (capability gap G-16).
+ *
+ * Same defect as the `StepStatus` block above: `FieldHelp` was exported as a
+ * VALUE while the types describing what it accepts were not re-exported here,
+ * so a host maintaining a help-copy dictionary had to hand-declare the entry
+ * shape — which the Platform TypeScript Guidelines forbid ("Reusable types
+ * belong inside Shared UI Library … Never duplicate"). addpe-fe's `HELP_TEXTS`
+ * carries exactly that local twin (`HelpTextEntry`), with a comment recording
+ * that `FieldHelpProps` was unreachable.
+ *
+ * `FieldHelpVariant` / `FieldHelpIcon` travel with it: a dictionary that sets
+ * `variant` per entry needs the union, and re-declaring `"tooltip" | "popover"`
+ * at the call site is the same duplication one level down.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+export type { FieldHelpProps, FieldHelpVariant, FieldHelpIcon } from "./FieldHelp";
+export { default as SkipLink } from "./SkipLink";
+export { default as ProgressBar } from "./ProgressBar";
+export { default as Segmented } from "./Segmented";
+export { default as Dropzone } from "./Dropzone";
+export type { DropzoneProps, DropzoneFile, DropzoneFileStatus, DropzoneRejection, DropzoneRejectReason, DropzoneReasons, DropzoneLabels, } from "./Dropzone";
+export { default as CommandPalette } from "./CommandPalette";
+export { default as SectionBusy, PageBusy } from "./Busy";
+export { default as FormGrid } from "./FormGrid";
+export { default as KVGrid } from "./KVGrid";
+/**
+ * Surface — the bare card container (capability gap G-10).
+ *
+ * The card recipe (--surface + --border + -r-lg + --shadow-*) existed only
+ * WELDED INSIDE FormSection, which also imposes a numbered heading and an inner
+ * FormGrid. A consumer needing just the container — a DataGrid shell, a hero
+ * card, a sticky side rail, a nested file row — could not reach it and rewrote
+ * the recipe: three copies in addpe-fe plus a document card repeated across
+ * three files, each having picked its own elevation and radius from memory.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as Surface } from "./Surface";
+export type { SurfaceProps, SurfaceTone, SurfaceElevation, SurfaceRadius, SurfacePadding, } from "./Surface";
+/**
+ * FileCard — an attached document, displayed (capability gap G-12).
+ *
+ * The library shipped `Dropzone`, the UPLOAD affordance, and nothing for the
+ * state immediately after it. So every screen showing an attachment rebuilt the
+ * same row: three copies in addpe-fe, with THREE different paddings for one
+ * concept — accidental drift, exactly what R-2.1 forbids. Composes `Surface`.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ */
+export { default as FileCard } from "./FileCard";
+export type { FileCardProps } from "./FileCard";
+export { Box, Stack } from "./Layout";
+export { default as SectionHeader } from "./SectionHeader";
+export { default as Accordion } from "./Accordion";
+export { default as Tooltip } from "./Tooltip";
+export { default as ActionStrip } from "./ActionStrip";
+export { default as CategoryTag } from "./CategoryTag";
+export { default as FavoriteToggle } from "./FavoriteToggle";
+export { default as PdfViewer } from "./PdfViewer";
+export type { PdfViewerProps } from "./PdfViewer";
+export { default as ForbiddenPage } from "./ForbiddenPage";
+export { default as NotFoundPage } from "./NotFoundPage";
+export { default as ServerErrorPage } from "./ServerErrorPage";
+export { default as NetworkErrorPage } from "./NetworkErrorPage";
+/**
+ * Error-page prop contracts — public typed surface (capability gap G-32).
+ *
+ * The four pages are deliberately router-agnostic: they take `onBack` /
+ * `onHome` / `onRetry` callbacks instead of importing a router hook. That
+ * design REQUIRES every consumer to write a thin adapter binding its own
+ * router to those callbacks — and each adapter needs the prop type to declare
+ * what it is producing. The types existed on each module but were not
+ * re-exported here, so the adapters could not reach them: caution-ui's
+ * ErrorPages.tsx carried four
+ * `as React.ComponentProps<typeof V2ForbiddenPage>` assertions for no reason
+ * other than that `ForbiddenPageProps` was unreachable.
+ *
+ * A router adapter is the single most-repeated consumer of these components
+ * across the fleet — one per module — so leaving the contract unreachable
+ * guaranteed the same four casts in every repository.
+ *
+ * FLAT-ONLY, per the policy note in src/lib/index.ts.
+ * Additive and type-only: no runtime change, no existing export altered.
+ */
+export type { ForbiddenPageProps } from "./ForbiddenPage";
+export type { NotFoundPageProps } from "./NotFoundPage";
+export type { ServerErrorPageProps } from "./ServerErrorPage";
+export type { NetworkErrorPageProps } from "./NetworkErrorPage";
+//# sourceMappingURL=index.d.ts.map

package/dist/v2/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/components/index.ts"],"names":[],"mappings":"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"}