@super-ic/primitives

Canonical React controls for SuperIC consumers. The original catalog resolves 44 primitive families. Additional controls have their own source contracts and maturity; the original catalog count is not the complete export inventory.

Import the documented CSS once in the consumer's Tailwind entry:

@import "tailwindcss";
@import "@super-ic/primitives/tailwind.css";

Use the root barrel or a documented component subpath:

import { Button, Input } from "@super-ic/primitives";
import { Select, SelectContent } from "@super-ic/primitives/select";

sheet and tooltip have accepted source contracts. portal-container is a public support entrypoint. Wrap each local tenant/theme scope in PortalContainerProvider; import the provider and controls from the same installed package instance. Mixing source aliases and installed exports can create separate React contexts and send overlays outside their intended scope.

dialog and alert-dialog are newly exported candidates. Storybook and focused source/browser evidence do not constitute release acceptance. Consult design-system/component-contracts/components.json and the generated agent guides for current maturity and source-bound proof.

Dialog callers own open state and draft persistence. AlertDialogAction does not close automatically: keep a failed operation visible with its context and close only after the caller's command succeeds. Pending dismissal policy belongs to that command; cancel Base UI's close event when dismissal would lose necessary state. Every popup requires a title and an accessible description or label. For a standalone DialogPortal or AlertDialogPortal, an explicit container takes priority over the scoped provider. Resolve callback-ref targets before passing them; assigning ref.current alone does not schedule a render.

Interactive entries retain their client boundaries. Static exports and pure variant helpers remain callable from React Server Component code. Consumers bind @super-ic/icon-contracts/nucleo at their server and client roots before rendering primitives that use semantic glyphs.