@kanzo-tech/ui 0.0.1-alpha

package/dist/composites/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sources":["../../src/composites/sidebar.tsx"],"sourcesContent":["\"use client\";\n\nimport { ark } from \"@ark-ui/react/factory\";\nimport { PanelLeftIcon } from \"lucide-react\";\nimport React from \"react\";\nimport { tv, type VariantProps } from \"tailwind-variants\";\nimport { cn } from \"../lib/cn\";\nimport { Button, buttonVariants } from \"../simples/button\";\nimport { Input } from \"../simples/input\";\nimport { ScrollArea } from \"../simples/scroll-area\";\nimport { Separator } from \"../simples/separator\";\nimport {\n  Sheet,\n  SheetContent,\n  SheetHeader,\n} from \"../simples/sheet\";\nimport { Skeleton } from \"../simples/skeleton\";\nimport {\n  Tooltip,\n  TooltipContent,\n  TooltipTrigger,\n} from \"../simples/tooltip\";\nimport { useIsMobile } from \"../lib/use-is-mobile.js\";\n\nconst SIDEBAR_COOKIE_NAME = \"sidebar_state\";\nconst SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;\nconst SIDEBAR_WIDTH = \"16rem\";\nconst SIDEBAR_WIDTH_MOBILE = \"18rem\";\nconst SIDEBAR_WIDTH_ICON = \"3rem\";\nconst SIDEBAR_KEYBOARD_SHORTCUT = \"b\";\n\ninterface SidebarContextProps {\n  isMobile: boolean;\n  open: boolean;\n  openMobile: boolean;\n  setOpen: (open: boolean) => void;\n  setOpenMobile: (open: boolean) => void;\n  state: \"expanded\" | \"collapsed\";\n  toggleSidebar: () => void;\n}\n\nconst SidebarContext = React.createContext<SidebarContextProps | null>(null);\nSidebarContext.displayName = \"SidebarContext\";\n\ninterface SidebarProviderProps extends React.ComponentProps<\"div\"> {\n  /**\n   * The default open state of the sidebar.\n   *\n   * @default true\n   */\n  defaultOpen?: boolean;\n  /**\n   * The function to call when the open state of the sidebar changes.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * The open state of the sidebar.\n   */\n  open?: boolean;\n}\n\nexport const SidebarProvider = (props: SidebarProviderProps) => {\n  const {\n    defaultOpen = true,\n    open: openProp,\n    onOpenChange: setOpenProp,\n    className,\n    style,\n    slot,\n    ...rest\n  } = props;\n\n  const isMobile = useIsMobile();\n  const [openMobile, setOpenMobile] = React.useState(false);\n\n  const [_open, _setOpen] = React.useState(defaultOpen);\n  const open = openProp ?? _open;\n  const setOpen = React.useCallback(\n    (value: boolean | ((value: boolean) => boolean)) => {\n      const openState = typeof value === \"function\" ? value(open) : value;\n      if (setOpenProp) {\n        setOpenProp(openState);\n      } else {\n        _setOpen(openState);\n      }\n\n      // biome-ignore lint/suspicious/noDocumentCookie: Persist the sidebar state across reloads.\n      document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;\n    },\n    [setOpenProp, open]\n  );\n\n  const toggleSidebar = React.useCallback(() => {\n    if (isMobile) {\n      setOpenMobile((open) => !open);\n    } else {\n      setOpen((open) => !open);\n    }\n  }, [isMobile, setOpen]);\n\n  React.useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (\n        event.key === SIDEBAR_KEYBOARD_SHORTCUT &&\n        (event.metaKey || event.ctrlKey)\n      ) {\n        event.preventDefault();\n        toggleSidebar();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [toggleSidebar]);\n\n  const state = open ? \"expanded\" : \"collapsed\";\n\n  const contextValue = React.useMemo<SidebarContextProps>(\n    () => ({\n      state,\n      open,\n      setOpen,\n      isMobile,\n      openMobile,\n      setOpenMobile,\n      toggleSidebar,\n    }),\n    [state, open, setOpen, isMobile, openMobile, toggleSidebar]\n  );\n\n  return (\n    <SidebarContext.Provider value={contextValue}>\n      <ark.div\n        className={cn(\n          \"group/sidebar-wrapper\",\n          \"flex\",\n          \"min-h-svh w-full\",\n          \"has-data-[variant=inset]:bg-sidebar\",\n          className\n        )}\n        style={\n          {\n            \"--sidebar-width\": SIDEBAR_WIDTH,\n            \"--sidebar-width-icon\": SIDEBAR_WIDTH_ICON,\n            ...style,\n          } as React.CSSProperties\n        }\n        {...rest}\n        data-slot={slot ?? \"sidebar-wrapper\"}\n      />\n    </SidebarContext.Provider>\n  );\n};\n\ninterface SidebarProps extends React.ComponentProps<typeof Sheet> {\n  className?: string;\n  slot?: string;\n  collapsible?: \"offcanvas\" | \"icon\" | \"none\";\n  placement?: \"left\" | \"right\";\n  variant?: \"sidebar\" | \"floating\" | \"inset\";\n}\n\nexport const Sidebar = (props: SidebarProps) => {\n  const {\n    collapsible = \"offcanvas\",\n    placement = \"left\",\n    variant = \"sidebar\",\n    className,\n    children,\n    slot,\n    ...rest\n  } = props;\n\n  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();\n\n  if (collapsible === \"none\") {\n    return (\n      <ark.aside\n        className={cn(\n          \"h-full w-(--sidebar-width)\",\n          \"flex flex-col\",\n          \"bg-sidebar\",\n          \"text-sidebar-foreground\",\n          className\n        )}\n        {...rest}\n        data-slot={slot ?? \"sidebar\"}\n      >\n        {children}\n      </ark.aside>\n    );\n  }\n\n  if (isMobile) {\n    return (\n      <Sheet\n        {...rest}\n        onOpenChange={({ open }) => setOpenMobile(open)}\n        open={openMobile}\n      >\n        <SheetContent\n          className={cn(\n            \"w-(--sidebar-width)\",\n            \"p-0\",\n            \"bg-sidebar\",\n            \"text-sidebar-foreground\",\n            \"[&>button]:hidden\"\n          )}\n          data-mobile=\"true\"\n          data-sidebar=\"sidebar\"\n          slot={slot ?? \"sidebar\"}\n          placement={placement === \"left\" ? \"left\" : \"right\"}\n          style={\n            {\n              \"--sidebar-width\": SIDEBAR_WIDTH_MOBILE,\n            } as React.CSSProperties\n          }\n        >\n          <SheetHeader\n            className=\"sr-only\"\n            description=\"Displays the mobile sidebar.\"\n            title=\"Sidebar\"\n          />\n          <ark.div className=\"flex size-full flex-col\">{children}</ark.div>\n        </SheetContent>\n      </Sheet>\n    );\n  }\n\n  return (\n    <ark.div\n      className={cn(\"group peer\", \"hidden md:block\", \"text-sidebar-foreground\")}\n      data-collapsible={state === \"collapsed\" ? collapsible : \"\"}\n      data-placement={placement}\n      data-slot={slot ?? \"sidebar\"}\n      data-state={state}\n      data-variant={variant}\n    >\n      <ark.div\n        className={cn(\n          \"relative\",\n          \"w-(--sidebar-width)\",\n          \"bg-transparent\",\n          \"transition-[width] duration-200 ease-linear\",\n          \"group-data-[collapsible=offcanvas]:w-0\",\n          \"group-data-[placement=right]:rotate-180\",\n          variant === \"floating\" || variant === \"inset\"\n            ? \"group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]\"\n            : \"group-data-[collapsible=icon]:w-(--sidebar-width-icon)\",\n          \"motion-reduce:transition-none!\"\n        )}\n        data-slot=\"sidebar-gap\"\n      />\n      <ark.div\n        className={cn(\n          \"fixed inset-y-0 z-10\",\n          \"w-(--sidebar-width)\",\n          \"hidden md:flex\",\n          \"h-svh\",\n          \"transition-[inset-inline-start,inset-inline-end,width] duration-200 ease-linear\",\n          placement === \"left\"\n            ? \"inset-s-0 group-data-[collapsible=offcanvas]:-inset-s-(--sidebar-width)\"\n            : \"inset-e-0 group-data-[collapsible=offcanvas]:-inset-e-(--sidebar-width)\",\n          variant === \"floating\" || variant === \"inset\"\n            ? \"p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]\"\n            : \"group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[placement=right]:border-s group-data-[placement=left]:border-e\",\n          \"motion-reduce:transition-none!\",\n          className\n        )}\n        {...rest}\n        data-slot=\"sidebar-container\"\n      >\n        <ark.aside\n          className={cn(\n            \"size-full\",\n            \"flex flex-col\",\n            \"bg-sidebar\",\n            \"group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm\"\n          )}\n          data-sidebar=\"sidebar\"\n          data-slot=\"sidebar-inner\"\n        >\n          {children}\n        </ark.aside>\n      </ark.div>\n    </ark.div>\n  );\n};\n\nexport const SidebarTrigger = (props: React.ComponentProps<typeof Button>) => {\n  const { className, onClick, slot, ...rest } = props;\n\n  const { toggleSidebar } = useSidebar();\n\n  return (\n    <Button\n      className={cn(\"size-7\", className)}\n      data-sidebar=\"trigger\"\n      onClick={(event) => {\n        onClick?.(event);\n        toggleSidebar();\n      }}\n      size=\"icon-md\"\n      variant=\"ghost\"\n      {...rest}\n      slot={slot ?? \"sidebar-trigger\"}\n    >\n      <PanelLeftIcon className=\"rtl:rotate-180\" />\n      <ark.span className=\"sr-only\">Toggle Sidebar</ark.span>\n    </Button>\n  );\n};\n\nexport const SidebarRail = (props: React.ComponentProps<typeof ark.button>) => {\n  const { className, slot, ...rest } = props;\n\n  const { toggleSidebar } = useSidebar();\n\n  return (\n    <ark.button\n      aria-label=\"Toggle Sidebar\"\n      className={cn(\n        \"absolute inset-y-0 z-20 -translate-x-1/2\",\n        \"w-4\",\n        \"hidden sm:flex\",\n        \"transition-all ease-linear\",\n        \"after:absolute after:inset-s-1/2 after:inset-y-0 after:w-[2px]\",\n        \"hover:after:bg-sidebar-border\",\n        \"group-data-[placement=left]:-inset-e-4 group-data-[placement=right]:inset-s-0\",\n        \"in-data-[placement=left]:cursor-w-resize in-data-[placement=right]:cursor-e-resize\",\n        \"[[data-placement=left][data-state=collapsed]_&]:cursor-e-resize [[data-placement=right][data-state=collapsed]_&]:cursor-w-resize\",\n        \"group-data-[collapsible=offcanvas]:translate-x-0 hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:after:inset-s-full\",\n        \"[[data-placement=left][data-collapsible=offcanvas]_&]:-inset-e-2\",\n        \"[[data-placement=right][data-collapsible=offcanvas]_&]:-inset-s-2\",\n        \"motion-reduce:transition-none!\",\n        className\n      )}\n      data-sidebar=\"rail\"\n      onClick={toggleSidebar}\n      tabIndex={-1}\n      title=\"Toggle Sidebar\"\n      type=\"button\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-rail\"}\n    />\n  );\n};\n\n// A neutral offset column, not `<main>`: the content shell goes inside it and `ShellMain` owns\n// the landmark (one `<main>` per page; a region declares no role).\nexport const SidebarInset = (props: React.ComponentProps<typeof ark.div>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\n        \"relative flex w-full min-w-0 flex-1 flex-col bg-background\",\n        \"md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ms-2\",\n        \"md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ms-0\",\n        \"md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm\",\n        className\n      )}\n      {...rest}\n      data-slot={slot ?? \"sidebar-inset\"}\n    />\n  );\n};\n\nexport const SidebarInput = (props: React.ComponentProps<typeof Input>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <Input\n      className={cn(\"h-8 w-full bg-background shadow-none\", className)}\n      data-sidebar=\"input\"\n      {...rest}\n      slot={slot ?? \"sidebar-input\"}\n    />\n  );\n};\n\nexport const SidebarHeader = (props: React.ComponentProps<typeof ark.div>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      data-sidebar=\"header\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-header\"}\n    />\n  );\n};\n\nexport const SidebarFooter = (props: React.ComponentProps<typeof ark.div>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      data-sidebar=\"footer\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-footer\"}\n    />\n  );\n};\n\nexport const SidebarSeparator = (\n  props: React.ComponentProps<typeof Separator>\n) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <Separator\n      className={cn(\"mx-2 w-auto bg-sidebar-border\", className)}\n      data-sidebar=\"separator\"\n      {...rest}\n      slot={slot ?? \"sidebar-separator\"}\n    />\n  );\n};\n\ninterface SidebarContentProps extends React.ComponentProps<\"div\"> {\n  /**\n   * Whether to add a scroll fade effect to the sidebar content.\n   *\n   * @default false\n   */\n  scrollFade?: boolean;\n}\nexport const SidebarContent = (props: SidebarContentProps) => {\n  const { scrollFade = false, className, slot, ...rest } = props;\n\n  return (\n    <ScrollArea\n      className=\"[--fade-size:3rem] **:data-[slot=scroll-area-scrollbar]:hidden\"\n      scrollFade={scrollFade}\n    >\n      <ark.div\n        className={cn(\n          \"min-h-0\",\n          \"flex flex-1 flex-col gap-0\",\n          \"overflow-auto\",\n          \"group-data-[collapsible=icon]:overflow-hidden\",\n          className\n        )}\n        data-sidebar=\"content\"\n        {...rest}\n        data-slot={slot ?? \"sidebar-content\"}\n      />\n    </ScrollArea>\n  );\n};\n\nexport const SidebarGroup = (props: React.ComponentProps<typeof ark.div>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\"relative flex w-full min-w-0 flex-col p-2\", className)}\n      data-sidebar=\"group\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-group\"}\n    />\n  );\n};\n\nexport const SidebarGroupLabel = (\n  props: React.ComponentProps<typeof ark.div>\n) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\n        \"h-8\",\n        \"px-2\",\n        \"flex shrink-0 items-center\",\n        \"font-medium text-sidebar-foreground/70 text-xs\",\n        \"rounded-md\",\n        \"transition-[margin,opacity] duration-200 ease-linear\",\n        \"outline-hidden ring-sidebar-ring focus-visible:ring-2\",\n        \"[&_svg]:size-4 [&_svg]:shrink-0\",\n        \"group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0\",\n        \"motion-reduce:transition-none!\",\n        className\n      )}\n      data-sidebar=\"group-label\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-group-label\"}\n    />\n  );\n};\n\nexport const SidebarGroupAction = (\n  props: React.ComponentProps<typeof ark.button>\n) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.button\n      className={cn(\n        buttonVariants({\n          variant: \"ghost\",\n          size: \"icon-sm\",\n          clickEffect: false,\n        }),\n        \"absolute inset-e-3 top-3.5\",\n        \"text-sidebar-foreground\",\n        \"transition-transform\",\n        \"hover:bg-sidebar-accent hover:text-sidebar-accent-foreground\",\n        \"[&_svg]:size-4 [&_svg]:shrink-0\",\n        \"after:absolute after:-inset-2 md:after:hidden\",\n        \"group-data-[collapsible=icon]:hidden\",\n        \"motion-reduce:transition-none!\",\n        className\n      )}\n      data-sidebar=\"group-action\"\n      type=\"button\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-group-action\"}\n    />\n  );\n};\n\nexport const SidebarGroupContent = (\n  props: React.ComponentProps<typeof ark.div>\n) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(\"w-full text-sm\", className)}\n      data-sidebar=\"group-content\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-group-content\"}\n    />\n  );\n};\n\nexport const SidebarMenu = (props: React.ComponentProps<typeof ark.ul>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.ul\n      className={cn(\"w-full min-w-0\", \"flex flex-col gap-0\", className)}\n      data-sidebar=\"menu\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu\"}\n    />\n  );\n};\n\nexport const SidebarMenuItem = (props: React.ComponentProps<typeof ark.li>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.li\n      className={cn(\"group/menu-item relative\", className)}\n      data-sidebar=\"menu-item\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-item\"}\n    />\n  );\n};\n\ninterface SidebarMenuButtonProps extends React.ComponentProps<typeof Button> {\n  /**\n   * Whether the button is active.\n   *\n   * @default false\n   */\n  isActive?: boolean;\n  /**\n   * The tooltip to display when hovering over the button.\n   *\n   */\n  tooltip?: string | React.ComponentProps<typeof TooltipContent>;\n}\n\nexport const SidebarMenuButton = ({\n  tooltip,\n  ...props\n}: SidebarMenuButtonProps) => {\n  const {\n    isActive = false,\n    size = \"md\",\n    variant = \"ghost\",\n    className,\n    slot,\n    ...rest\n  } = props;\n\n  const { isMobile, state } = useSidebar();\n\n  const button = (\n    <Button\n      className={cn(\n        \"peer/menu-button group/menu-button\",\n        \"w-full\",\n        \"justify-start gap-2\",\n        \"p-2\",\n        \"overflow-hidden\",\n        \"transition-[width,height,padding]\",\n        \"data-[size=sm]:text-xs\",\n        \"data-[size=lg]:h-12\",\n        \"group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2!\",\n        \"data-[size=lg]:group-data-[collapsible=icon]:p-0!\",\n        \"hover:bg-sidebar-accent hover:text-sidebar-accent-foreground\",\n        // Upstream spells the width `sidebar-ring-[3px]`, which is not a utility — Tailwind emits\n        // nothing for it, so these two buttons set a ring colour and no ring, and the focus\n        // indicator never renders. The colour was the banned dilution besides: measured 1.49:1 in\n        // light and 1.42–1.46 in dark against the surfaces the sidebar sits on, against 4.54 and\n        // 3.89–4.18 solid. Nothing else here changes on focus, so the ring is the whole indicator.\n        \"outline-none focus-visible:ring-[3px] focus-visible:ring-sidebar-ring\",\n        \"active:bg-sidebar-accent active:text-sidebar-accent-foreground\",\n        \"data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground\",\n        \"group-has-data-[sidebar=menu-action]/menu-item:pe-8\",\n        \"[&>span:last-child]:truncate\",\n        \"motion-reduce:transition-none!\",\n        className\n      )}\n      clickEffect={false}\n      data-active={isActive}\n      data-sidebar=\"menu-button\"\n      data-size={size}\n      size={size}\n      variant={variant}\n      {...rest}\n      slot={slot ?? \"sidebar-menu-button\"}\n    />\n  );\n\n  if (!tooltip) {\n    return button;\n  }\n\n  if (typeof tooltip === \"string\") {\n    tooltip = {\n      children: tooltip,\n    };\n  }\n\n  return (\n    <Tooltip positioning={{ placement: \"right\" }}>\n      <TooltipTrigger asChild>{button}</TooltipTrigger>\n      <TooltipContent hidden={state !== \"collapsed\" || isMobile} {...tooltip} />\n    </Tooltip>\n  );\n};\n\ninterface SidebarMenuActionProps\n  extends React.ComponentProps<typeof ark.button> {\n  showOnHover?: boolean;\n}\n\nexport const SidebarMenuAction = (props: SidebarMenuActionProps) => {\n  const { className, showOnHover = false, slot, ...rest } = props;\n\n  return (\n    <ark.button\n      className={cn(\n        buttonVariants({\n          variant: \"ghost\",\n          size: \"icon-sm\",\n          clickEffect: false,\n        }),\n        \"absolute inset-e-1 top-1.5\",\n        \"text-sidebar-foreground\",\n        \"transition-transform\",\n        \"hover:bg-sidebar-accent hover:text-sidebar-accent-foreground\",\n        \"peer-hover/menu-button:text-sidebar-accent-foreground\",\n        \"after:absolute after:-inset-2 md:after:hidden\",\n        \"peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=md]/menu-button:top-1.5 peer-data-[size=sm]/menu-button:top-1\",\n        \"group-data-[collapsible=icon]:hidden\",\n        \"[&_svg]:size-4 [&_svg]:shrink-0\",\n        !showOnHover &&\n          \"group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-[state=open]:opacity-100 peer-data-[active=true]/menu-button:text-sidebar-accent-foreground md:opacity-0\",\n        \"motion-reduce:transition-none!\",\n        className\n      )}\n      data-sidebar=\"menu-action\"\n      type=\"button\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-action\"}\n    />\n  );\n};\n\nconst sidebarMenuBadgeVariants = tv({\n  base: [\n    \"flex items-center justify-center\",\n    \"px-1\",\n    \"h-5 min-w-5\",\n    \"rounded-md\",\n    \"select-none font-medium text-sidebar-foreground text-xs tabular-nums\",\n    \"group-data-[collapsible=icon]:hidden\",\n  ],\n  variants: {\n    placement: {\n      /** Overlaid on the row's trailing edge, sized off the peer button (Shark/shadcn default). */\n      overlay: [\n        \"pointer-events-none absolute inset-e-1\",\n        \"peer-hover/menu-button:text-sidebar-accent-foreground\",\n        \"peer-data-[active=true]/menu-button:text-sidebar-accent-foreground\",\n        \"peer-data-[size=lg]/menu-button:top-2.5\",\n        \"peer-data-[size=md]/menu-button:top-1.5\",\n        \"peer-data-[size=sm]/menu-button:top-1\",\n      ],\n      /**\n       * In the flow, INSIDE the row. Required whenever the row already ends in something else\n       * (a chevron, a `SidebarMenuAction`): the overlay placement would stack on top of it.\n       */\n      inline: \"ms-auto shrink-0\",\n    },\n  },\n  defaultVariants: { placement: \"overlay\" },\n});\n\nexport interface SidebarMenuBadgeProps\n  extends React.ComponentProps<typeof ark.div>,\n    VariantProps<typeof sidebarMenuBadgeVariants> {}\n\nexport const SidebarMenuBadge = (props: SidebarMenuBadgeProps) => {\n  const { className, placement = \"overlay\", slot, ...rest } = props;\n\n  return (\n    <ark.div\n      className={cn(sidebarMenuBadgeVariants({ placement }), className)}\n      data-placement={placement}\n      data-sidebar=\"menu-badge\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-badge\"}\n    />\n  );\n};\n\ninterface SidebarMenuSkeletonProps\n  extends React.ComponentProps<typeof ark.div> {\n  showIcon?: boolean;\n}\n\nexport const SidebarMenuSkeleton = (props: SidebarMenuSkeletonProps) => {\n  const { className, showIcon = false, slot, ...rest } = props;\n\n  const width = React.useMemo(\n    () => `${Math.floor(Math.random() * 40) + 50}%`,\n    []\n  );\n\n  return (\n    <ark.div\n      className={cn(\"flex h-8 items-center gap-2 rounded-md px-2\", className)}\n      data-sidebar=\"menu-skeleton\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-skeleton\"}\n    >\n      {!!showIcon && (\n        <Skeleton\n          className=\"size-4 rounded-md\"\n          data-sidebar=\"menu-skeleton-icon\"\n        />\n      )}\n      <Skeleton\n        className=\"h-4 max-w-(--skeleton-width) flex-1\"\n        data-sidebar=\"menu-skeleton-text\"\n        style={\n          {\n            \"--skeleton-width\": width,\n          } as React.CSSProperties\n        }\n      />\n    </ark.div>\n  );\n};\n\nexport const SidebarMenuSub = (props: React.ComponentProps<typeof ark.ul>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.ul\n      className={cn(\n        \"mx-3.5 flex min-w-0 flex-col gap-1 px-2.5 py-0.5 ltr:translate-x-px rtl:-translate-x-px\",\n        \"border-sidebar-border border-s\",\n        \"group-data-[collapsible=icon]:hidden\",\n        className\n      )}\n      data-sidebar=\"menu-sub\"\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-sub\"}\n    />\n  );\n};\n\nexport const SidebarMenuSubItem = ({\n  className,\n  slot,\n  ...props\n}: React.ComponentProps<typeof ark.li>) => (\n  <ark.li\n    className={cn(\"group/menu-sub-item relative\", className)}\n    data-sidebar=\"menu-sub-item\"\n    {...props}\n    data-slot={slot ?? \"sidebar-menu-sub-item\"}\n  />\n);\n\ninterface SidebarMenuSubButtonProps\n  extends React.ComponentProps<typeof ark.a>,\n    VariantProps<typeof buttonVariants> {\n  isActive?: boolean;\n}\n\nexport const SidebarMenuSubButton = (props: SidebarMenuSubButtonProps) => {\n  const { size = \"md\", isActive = false, className, slot, ...rest } = props;\n\n  return (\n    <ark.a\n      className={cn(\n        buttonVariants({ size, variant: \"ghost\", clickEffect: false }),\n        \"w-full min-w-0\",\n        \"justify-start\",\n        \"px-2\",\n        \"text-sidebar-foreground\",\n        \"overflow-hidden\",\n        \"ltr:-translate-x-px rtl:translate-x-px\",\n        \"hover:bg-sidebar-accent hover:text-sidebar-accent-foreground\",\n        \"active:bg-sidebar-accent active:text-sidebar-accent-foreground\",\n        \"data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground\",\n        // Same non-utility width and same diluted ring as SidebarMenuButton — see the note there.\n        \"outline-none focus-visible:ring-[3px] focus-visible:ring-sidebar-ring\",\n        \"[&>span:last-child]:truncate\",\n        \"[&_svg]:text-sidebar-accent-foreground\",\n        className\n      )}\n      data-active={isActive}\n      data-sidebar=\"menu-sub-button\"\n      data-size={size}\n      {...rest}\n      data-slot={slot ?? \"sidebar-menu-sub-button\"}\n    />\n  );\n};\n\nexport const useSidebar = () => {\n  const context = React.useContext(SidebarContext);\n\n  if (context === null) {\n    throw new Error(\"useSidebar must be used within a SidebarProvider.\");\n  }\n\n  return context;\n};\n"],"names":["SidebarContext","React"],"mappings":";;;;;;;;;;;;;;;AAwBA;AAkBAA;AAmBO;AACL;AAAM;AACU;AACR;AACQ;AACd;AACA;AACA;AACG;AAQiB;AAElB;AACA;AAOgG;AAClG;AACkB;AAIlB;AAGyB;AAI3BC;AACE;AACE;AAKE;AAIJ;AAEgE;AAGlE;AAE2B;AAClB;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEwD;AAG5D;AAEI;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AAAA;AAGA;AACqB;AACK;AACrB;AAAA;AAGH;AACe;AAAA;AAI3B;AAWE;AAAM;AACU;AACF;AACF;AACV;AACA;AACA;AACG;AAKL;AAEI;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AAAA;AAEE;AACe;AAElB;AAAA;AAOH;AAAC;AAAA;AACK;AAC0C;AACxC;AAEN;AAAC;AAAA;AACY;AACT;AACA;AACA;AACA;AACA;AAAA;AAEU;AACC;AACC;AAC6B;AAEzC;AACqB;AAAA;AAIvB;AAAA;AAAC;AAAA;AACW;AACE;AACN;AAAA;AAAA;AAE+C;AAAA;AAAA;AAAA;AACzD;AAMJ;AAAK;AAAJ;AACyE;AAChB;AACxC;AACG;AACP;AACE;AAEd;AAAA;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AACA;AAGI;AACJ;AAAA;AAEQ;AAAA;AAAA;AAEZ;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AAGI;AAGA;AACJ;AACA;AAAA;AAEE;AACM;AAEV;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AAAA;AAEW;AACH;AAET;AAAA;AAAA;AACH;AAAA;AACF;AAAA;AAGN;AAGE;AAIA;AACE;AAAC;AAAA;AACkC;AACpB;AAEX;AACA;AACF;AACK;AACG;AACJ;AACU;AAEd;AAA0C;AACE;AAAA;AAAA;AAGlD;AAGE;AAIA;AACE;AAAK;AAAJ;AACY;AACA;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEW;AACJ;AACC;AACJ;AACD;AACD;AACe;AAAA;AAGzB;AAKE;AAEA;AACE;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AAAA;AAEE;AACe;AAAA;AAGzB;AAGE;AAEA;AACE;AAAC;AAAA;AACgE;AAClD;AACT;AACU;AAAA;AAGpB;AAGE;AAEA;AACE;AAAK;AAAJ;AACmD;AACrC;AACT;AACe;AAAA;AAGzB;AAGE;AAEA;AACE;AAAK;AAAJ;AACmD;AACrC;AACT;AACe;AAAA;AAGzB;AAKE;AAEA;AACE;AAAC;AAAA;AACyD;AAC3C;AACT;AACU;AAAA;AAGpB;AAWE;AAEA;AACE;AAAC;AAAA;AACW;AACV;AAEA;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AAAA;AAEW;AACT;AACe;AAAA;AAAA;AACrB;AAGN;AAGE;AAEA;AACE;AAAK;AAAJ;AACqE;AACvD;AACT;AACe;AAAA;AAGzB;AAKE;AAEA;AACE;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEW;AACT;AACe;AAAA;AAGzB;AAKE;AAEA;AACE;AAAK;AAAJ;AACY;AACM;AACJ;AACH;AACO;AACd;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEW;AACR;AACD;AACe;AAAA;AAGzB;AAKE;AAEA;AACE;AAAK;AAAJ;AAC0C;AAC5B;AACT;AACe;AAAA;AAGzB;AAGE;AAEA;AACE;AAAK;AAAJ;AACiE;AACnD;AACT;AACe;AAAA;AAGzB;AAGE;AAEA;AACE;AAAK;AAAJ;AACoD;AACtC;AACT;AACe;AAAA;AAGzB;AAgBkC;AAChC;AAEF;AACE;AAAM;AACO;AACJ;AACG;AACV;AACA;AACG;AAMH;AAAC;AAAA;AACY;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEW;AACA;AACA;AACF;AACX;AACA;AACI;AACU;AAAA;AAIlB;AAKY;AACE;AAMV;AAAgC;AACwC;AAG9E;AAQE;AAEA;AACE;AAAK;AAAJ;AACY;AACM;AACJ;AACH;AACO;AACd;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEE;AACF;AACA;AAAA;AAEW;AACR;AACD;AACe;AAAA;AAGzB;AAEoC;AAC5B;AACJ;AACA;AACA;AACA;AACA;AACA;AAAA;AAEQ;AACG;AAAA;AAEA;AACP;AACA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMM;AAAA;AACV;AAGJ;AAOE;AAEA;AACE;AAAK;AAAJ;AACiE;AAChD;AACH;AACT;AACe;AAAA;AAGzB;AAQE;AAEoB;AAC0B;AAC5C;AAGF;AACE;AAAK;AAAJ;AACuE;AACzD;AACT;AACe;AAElB;AACC;AAAC;AAAA;AACW;AACG;AAAA;AAAA;AAGjB;AAAC;AAAA;AACW;AACG;AAEX;AACsB;AAAA;AACtB;AAAA;AAEJ;AAAA;AAGN;AAGE;AAEA;AACE;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AAAA;AAEW;AACT;AACe;AAAA;AAGzB;AAEmC;AACjC;AACA;AAEF;AACE;AAAK;AAAJ;AACwD;AAC1C;AACT;AACe;AACrB;AAUA;AAEA;AACE;AAAK;AAAJ;AACY;AACoD;AAC7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAEA;AACA;AACA;AACA;AAAA;AAEW;AACA;AACF;AACP;AACe;AAAA;AAGzB;AAGE;AAEA;AACE;AAGF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/composites/theme-notice.d.ts

@@ -0,0 +1,54 @@
+import { CreateToasterReturn } from '@ark-ui/react/toast';
+/**
+ * The copy for "the theme you chose is no longer published", shared by the two surfaces that
+ * say it: this toast, and the `Alert` inside `Preferences.Colour`. One state, said once.
+ *
+ * Both strings are **library-authored English**, which is exactly the distinction `PreferencesColor`'s `formatSide`
+ * draws with its `formatName`: the library wrote "Light" and "Dark", so a caller who translates the
+ * app has to be able to translate them. A theme's `label` is the opposite case — the client
+ * authored it, at runtime — and takes no formatter, because a formatter over it would only let a
+ * host decorate someone else's brand name.
+ */
+export interface ThemeRetiredCopy {
+    /** Heading (i18n). */
+    title?: string;
+    /**
+     * Compose the body. The default frame is English; a caller who translates `title` needs this
+     * too, or the notice is half-translated.
+     *
+     * `theme` is the retired **name**, not a label: what the tenant withdrew is gone from
+     * `identities`, so its label went with it. A host that keeps its own table of retired names is
+     * the reason this is a function rather than a string.
+     */
+    formatDescription?: (parts: {
+        theme: string;
+    }) => string;
+}
+/** Resolve the copy once, so the toast and the panel's Alert cannot drift into two wordings. */
+export declare function themeRetiredCopy({ title, formatDescription }: ThemeRetiredCopy, theme: string): {
+    title: string;
+    description: string;
+};
+export interface ThemeNoticeProps extends ThemeRetiredCopy {
+    /** Feed a second, separately-placed viewport. Defaults to the shared `toast` instance. */
+    toaster?: CreateToasterReturn;
+}
+/**
+ * ThemeNotice — says, once, that the identity this user chose is no longer published.
+ *
+ * **Opt-in, and it renders nothing itself.** `KanzoThemeProvider` detects the retirement, clears
+ * the preference and holds the id in `retiredTheme`; it draws no surface, because a themer that
+ * draws its own surface is what `KanzoTheme` was deleted for (`index.test.ts` keeps it deleted).
+ * So mount this beside the host's own `<Toaster />` — it feeds that viewport and returns `null`.
+ *
+ * Why it is worth saying at all: the cascade already handled the colour. An attribute selector with
+ * no matching rule is inert, so a withdrawn id falls through to `:root`, which is the default
+ * identity. What is left is that somebody chose gold and is looking at blue, and silence makes that
+ * read as a bug in our product rather than a change in their client's.
+ *
+ * The panel says the same thing in `Preferences.Colour`, from the same state — and cannot always
+ * say it: that section hides itself below two published themes, so a tenant who retired their way
+ * down to one has this as the only surface left.
+ */
+export declare const ThemeNotice: ({ toaster, ...copy }?: ThemeNoticeProps) => null;
+//# sourceMappingURL=theme-notice.d.ts.map

package/dist/composites/theme-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-notice.d.ts","sourceRoot":"","sources":["../../src/composites/theme-notice.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC1D;AAMD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAC9B,EAAE,KAAqB,EAAE,iBAAuC,EAAE,EAAE,gBAAgB,EACpF,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAExC;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,0FAA0F;IAC1F,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,uBAAsC,gBAAqB,SAiBtF,CAAC"}

package/dist/composites/theme-notice.js

@@ -0,0 +1,19 @@
+"use client";
+import * as c from "react";
+import { toast as s } from "../simples/toast.js";
+import { useKanzoTheme as u } from "../theme/theme-context.js";
+const f = "Brand updated", d = ({ theme: t }) => `“${t}” is no longer offered here. You are seeing the default.`;
+function m({ title: t = f, formatDescription: r = d }, e) {
+  return { title: t, description: r({ theme: e }) };
+}
+const T = ({ toaster: t = s, ...r } = {}) => {
+  const { retiredTheme: e } = u(), { title: o, description: n } = m(r, e ?? ""), i = c.useRef(null);
+  return c.useEffect(() => {
+    !e || i.current === e || (i.current = e, t.create({ title: o, description: n, type: "info" }));
+  }, [e, o, n, t]), null;
+};
+export {
+  T as ThemeNotice,
+  m as themeRetiredCopy
+};
+//# sourceMappingURL=theme-notice.js.map

package/dist/composites/theme-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-notice.js","sources":["../../src/composites/theme-notice.tsx"],"sourcesContent":["\"use client\";\n\nimport type { CreateToasterReturn } from \"@ark-ui/react/toast\";\nimport * as React from \"react\";\nimport { toast as sharedToaster } from \"../simples/toast.js\";\nimport { useKanzoTheme } from \"../theme/KanzoThemeProvider.js\";\n\n/**\n * The copy for \"the theme you chose is no longer published\", shared by the two surfaces that\n * say it: this toast, and the `Alert` inside `Preferences.Colour`. One state, said once.\n *\n * Both strings are **library-authored English**, which is exactly the distinction `PreferencesColor`'s `formatSide`\n * draws with its `formatName`: the library wrote \"Light\" and \"Dark\", so a caller who translates the\n * app has to be able to translate them. A theme's `label` is the opposite case — the client\n * authored it, at runtime — and takes no formatter, because a formatter over it would only let a\n * host decorate someone else's brand name.\n */\nexport interface ThemeRetiredCopy {\n  /** Heading (i18n). */\n  title?: string;\n  /**\n   * Compose the body. The default frame is English; a caller who translates `title` needs this\n   * too, or the notice is half-translated.\n   *\n   * `theme` is the retired **name**, not a label: what the tenant withdrew is gone from\n   * `identities`, so its label went with it. A host that keeps its own table of retired names is\n   * the reason this is a function rather than a string.\n   */\n  formatDescription?: (parts: { theme: string }) => string;\n}\n\nconst DEFAULT_TITLE = \"Brand updated\";\nconst DEFAULT_DESCRIPTION = ({ theme }: { theme: string }) =>\n  `“${theme}” is no longer offered here. You are seeing the default.`;\n\n/** Resolve the copy once, so the toast and the panel's Alert cannot drift into two wordings. */\nexport function themeRetiredCopy(\n  { title = DEFAULT_TITLE, formatDescription = DEFAULT_DESCRIPTION }: ThemeRetiredCopy,\n  theme: string,\n): { title: string; description: string } {\n  return { title, description: formatDescription({ theme }) };\n}\n\nexport interface ThemeNoticeProps extends ThemeRetiredCopy {\n  /** Feed a second, separately-placed viewport. Defaults to the shared `toast` instance. */\n  toaster?: CreateToasterReturn;\n}\n\n/**\n * ThemeNotice — says, once, that the identity this user chose is no longer published.\n *\n * **Opt-in, and it renders nothing itself.** `KanzoThemeProvider` detects the retirement, clears\n * the preference and holds the id in `retiredTheme`; it draws no surface, because a themer that\n * draws its own surface is what `KanzoTheme` was deleted for (`index.test.ts` keeps it deleted).\n * So mount this beside the host's own `<Toaster />` — it feeds that viewport and returns `null`.\n *\n * Why it is worth saying at all: the cascade already handled the colour. An attribute selector with\n * no matching rule is inert, so a withdrawn id falls through to `:root`, which is the default\n * identity. What is left is that somebody chose gold and is looking at blue, and silence makes that\n * read as a bug in our product rather than a change in their client's.\n *\n * The panel says the same thing in `Preferences.Colour`, from the same state — and cannot always\n * say it: that section hides itself below two published themes, so a tenant who retired their way\n * down to one has this as the only surface left.\n */\nexport const ThemeNotice = ({ toaster = sharedToaster, ...copy }: ThemeNoticeProps = {}) => {\n  const { retiredTheme } = useKanzoTheme();\n  const { title, description } = themeRetiredCopy(copy, retiredTheme ?? \"\");\n\n  // Keyed on the id rather than a boolean: the provider's own ref guarantees it *detects* a\n  // retirement once, not that this effect runs once. Two things still reach it — StrictMode's\n  // double invocation when this mounts AFTER the detection (a host that renders the notice behind\n  // a route), and an inline `formatDescription`, which is a new function on every render and so a\n  // changed dep. Neither is the \"once per session\" question, which storage already answered.\n  const said = React.useRef<string | null>(null);\n  React.useEffect(() => {\n    if (!retiredTheme || said.current === retiredTheme) return;\n    said.current = retiredTheme;\n    toaster.create({ title, description, type: \"info\" });\n  }, [retiredTheme, title, description, toaster]);\n\n  return null;\n};\n"],"names":[],"mappings":";;;;AA+BA;AAKO;AAIL;AACF;AAwBO;AACL;AASA;AACE;AAEmD;AAIvD;;;;;"}

package/dist/editor.d.ts

@@ -0,0 +1,3 @@
+export { CodeEditor, kanzoHighlighting } from './composites/CodeEditor.js';
+export type { CodeEditorProps } from './composites/CodeEditor.js';
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/editor.js

@@ -0,0 +1,6 @@
+import { CodeEditor as g, kanzoHighlighting as r } from "./composites/CodeEditor.js";
+export {
+  g as CodeEditor,
+  r as kanzoHighlighting
+};
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/guard-corpus.d.ts

@@ -0,0 +1,63 @@
+export declare const REPO: string;
+export interface Root {
+    /** The workspace directory name — `ui`, `ai`. The first segment of every path a guard reports. */
+    readonly name: string;
+    /** Absolute path to that package's `src/`. */
+    readonly src: string;
+}
+/**
+ * Every package the scans cover, derived from the workspace rather than hard-coded to two paths.
+ *
+ * `packages/*` is one of the two globs in `pnpm-workspace.yaml`, read here as a directory listing:
+ * the other is `docs`, which is not a library.
+ */
+export declare const ROOTS: readonly Root[];
+/** `/Users/…/packages/ai/src/message.tsx` → `ai/message.tsx`. Throws rather than guessing. */
+export declare function label(file: string): string;
+/** The inverse, so a pinned list in a guard is spelled the way that guard's failures are. */
+export declare function resolvePath(reported: string): string;
+/**
+ * Every source file in the corpus, absolute, ordered by the path a failure would report.
+ *
+ * Tests are excluded: they quote the very spellings the rules ban, on purpose, and several of them
+ * assemble one at runtime to keep it out of Tailwind's scan.
+ */
+export declare function sourceFiles(extensions?: RegExp): string[];
+/**
+ * Every subtree a scan has to reach, spelled as a path prefix: `ui/simples/`, `ui/charts/`, `ai/`.
+ *
+ * This replaces the hand-written `LAYERS` array that four of these guards each kept a copy of. Those
+ * arrays could only name what somebody remembered to add, which is the failure mode they existed to
+ * prevent — a walk that stops descending reports the same green as a real pass, and so does a walk
+ * that never learned about a directory added last week. Derived, a new layer and a new package are
+ * both covered without an edit; the assertion is that each entry contributed at least one file, so
+ * an empty directory added to the tree fails here rather than passing everywhere.
+ *
+ * A package with sources at the top of its `src/` contributes its bare name. `ai` is flat and that
+ * is not drift — it has ten modules and no layer to sort them into, which is why the layer-shaped
+ * rules in `logical-properties.test.ts` stay scoped to the package that has layers.
+ */
+export declare function subtrees(): string[];
+/**
+ * The two assertions every one of these guards was making by hand, in the same words.
+ *
+ * A NUL byte makes `file(1)` and every `grep -I` treat a source file as binary and skip it in
+ * silence; `charts/chart-inputs.tsx` held one, in the largest file of the layer with the most colour
+ * in it. `readFileSync(…, "utf8")` reads it regardless, so none of these scans ever had that hole —
+ * but the next reader reaches for grep first, and a corpus that lies to grep is worth failing on.
+ * An empty file is the other half: a scan over nothing proves nothing.
+ */
+export declare function unreadable(files: string[]): {
+    binary: string[];
+    empty: string[];
+};
+/**
+ * Where a colour stops being a grey and starts being somebody's palette.
+ *
+ * `0.1` in OKLab chroma, and it is the number the retired package used — carried over rather than
+ * re-picked, because moving it would silently change which literals the guard bites on and that
+ * migration was not the place to re-argue it.
+ */
+export declare const CHROMA_FLOOR = 0.1;
+export { oklch } from '@kanzo-tech/theme';
+//# sourceMappingURL=guard-corpus.d.ts.map

package/dist/guard-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-corpus.d.ts","sourceRoot":"","sources":["../src/guard-corpus.ts"],"names":[],"mappings":"AA6DA,eAAO,MAAM,IAAI,QAA4B,CAAC;AAE9C,MAAM,WAAW,IAAI;IACnB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAOD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EA6B7B,CAAC;AA0BL,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,SAAY,GAAG,MAAM,EAAE,CAY5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAYnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAKjF;AASD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+export type { Appearance, AppearancePref, KanzoRadius, KanzoDensity, KanzoFont, KanzoMonoFont, KanzoThemeName, ThemeOption, } from '@kanzo-tech/theme';
+export { KanzoThemeProvider, useKanzoTheme, cookieStorageAdapter } from './theme/KanzoThemeProvider.js';
+export { KanzoTheme, type KanzoThemeProps } from './theme/KanzoTheme.js';
+export type { KanzoThemeProviderProps, ThemePrefs, FontOption, ThemeStorage, AppearanceController, } from './theme/KanzoThemeProvider.js';
+export { themeScript } from './theme/theme-script.js';
+export type { ThemeScriptOptions } from './theme/theme-script.js';
+export { Preferences, PreferencesRoot, PreferencesTrigger, PreferencesPanel, PreferencesField, PreferencesFieldSet, PreferencesColor, PreferencesRadius, PreferencesFont, PreferencesMonoFont, PreferencesDensity, PreferencesSections, } from './composites/Preferences.js';
+export type { PreferencesProps, PreferencesRootProps, PreferencesColorProps, PreferencesSectionsProps, } from './composites/Preferences.js';
+export { ThemeNotice } from './composites/theme-notice.js';
+export type { ThemeNoticeProps, ThemeRetiredCopy } from './composites/theme-notice.js';
+export { MadeWith } from './composites/MadeWith.js';
+export type { MadeWithProps } from './composites/MadeWith.js';
+export { Questionnaire, QuestionnaireProgress, QuestionnaireItem, QuestionnaireTitle, QuestionnaireDescription, QuestionnaireError, QuestionnaireChoices, QuestionnaireChoice, QuestionnaireInput, QuestionnaireTextarea, QuestionnaireActions, QuestionnairePrevious, QuestionnaireSkip, QuestionnaireNext, QuestionnaireSubmit, useQuestionnaire, useQuestionnaireItem, } from './composites/Questionnaire.js';
+export type { QuestionnaireAnswer, QuestionnaireAnswers, QuestionnaireQuestion, QuestionnaireProps, QuestionnaireItemProps, QuestionnaireChoicesProps, QuestionnaireChoiceProps, QuestionnaireActionsProps, } from './composites/Questionnaire.js';
+export { cn } from './lib/cn.js';
+export { CHART_SLOTS, categoricalCapacity, categoricalColor, resolveTokenColor, } from './lib/token-color.js';
+export { useChartCapacity, useThemeTick } from './lib/theme-tick.js';
+export { createListCollection, useListCollection, } from '@ark-ui/react/collection';
+export type { ListCollection, CollectionItem } from '@ark-ui/react/collection';
+export { useFilter } from '@ark-ui/react/locale';
+export { parseDate } from '@internationalized/date';
+export type { DateValue } from '@internationalized/date';
+export * from './simples/accordion.js';
+export * from './simples/action-bar.js';
+export * from './simples/alert.js';
+export * from './simples/alert-dialog.js';
+export * from './simples/avatar.js';
+export * from './simples/badge.js';
+export * from './simples/breadcrumb.js';
+export * from './simples/button.js';
+export * from './simples/button-group.js';
+export * from './simples/calendar.js';
+export * from './simples/card.js';
+export * from './simples/checkbox.js';
+export * from './simples/client-only.js';
+export * from './simples/clipboard.js';
+export * from './simples/download-trigger.js';
+export * from './simples/color-picker.js';
+export * from './simples/collapsible.js';
+export * from './simples/combobox.js';
+export * from './simples/command.js';
+export * from './simples/data-list.js';
+export * from './simples/date-picker.js';
+export * from './simples/dialog.js';
+export * from './simples/diagnostic.js';
+export * from './simples/editable.js';
+export * from './simples/field.js';
+export * from './simples/file-upload.js';
+export * from './simples/float.js';
+export * from './simples/floating-panel.js';
+export * from './simples/highlight.js';
+export * from './simples/hover-card.js';
+export * from './simples/image-cropper.js';
+export * from './simples/input.js';
+export * from './simples/input-group.js';
+export * from './simples/item.js';
+export * from './simples/json-tree-view.js';
+export * from './simples/kbd.js';
+export * from './simples/listbox.js';
+export * from './simples/menu.js';
+export * from './simples/native-select.js';
+export * from './simples/number-input.js';
+export * from './simples/pagination.js';
+export * from './simples/password-input.js';
+export * from './simples/pin-input.js';
+export * from './simples/popover.js';
+export * from './simples/progress.js';
+export * from './simples/prose.js';
+export * from './simples/radio-group.js';
+export * from './simples/rating.js';
+export * from './simples/segment-group.js';
+export * from './simples/resizable.js';
+export * from './simples/scroll-area.js';
+export * from './simples/select.js';
+export * from './simples/sheet.js';
+export * from './simples/separator.js';
+export * from './simples/show.js';
+export * from './simples/skeleton.js';
+export * from './simples/skip-nav.js';
+export * from './simples/slider.js';
+export * from './simples/spinner.js';
+export * from './simples/stat-tile.js';
+export * from './simples/suggestions.js';
+export * from './simples/swatch.js';
+export * from './simples/status.js';
+export * from './simples/steps.js';
+export * from './simples/switch.js';
+export * from './simples/table.js';
+export * from './simples/tabs.js';
+export * from './simples/tags-input.js';
+export * from './simples/textarea.js';
+export * from './simples/toast.js';
+export * from './simples/toggle.js';
+export * from './simples/toggle-group.js';
+export * from './simples/tooltip.js';
+export * from './simples/tour.js';
+export * from './simples/tree-view.js';
+export { Link } from './simples/Link.js';
+export type { LinkProps } from './simples/Link.js';
+export { FieldArray } from './simples/FieldArray.js';
+export type { FieldArrayProps } from './simples/FieldArray.js';
+export { FacetFilter } from './simples/FacetFilter.js';
+export type { FacetFilterProps, FacetFilterItem } from './simples/FacetFilter.js';
+export { ShellRoot, ShellHeader, ShellBody, ShellAside, ShellMain, ShellFooter, } from './layouts/shell.js';
+export type { ShellAsideProps } from './layouts/shell.js';
+export { SectionRoot, SectionHeader, SectionIcon, SectionTitleGroup, SectionTitle, SectionDescription, SectionActions, SectionBody, SectionFooter, } from './layouts/section.js';
+export type { SectionRootProps, SectionHeaderProps, SectionTitleProps, SectionBodyProps, } from './layouts/section.js';
+export * from './composites/sidebar.js';
+export { SidebarIdentity, SidebarIdentityAvatar, SidebarIdentityDescription, SidebarIdentityIcon, SidebarIdentityLabel, SidebarIdentityText, } from './composites/SidebarIdentity.js';
+export type { SidebarIdentityProps } from './composites/SidebarIdentity.js';
+export { isActivePath } from './lib/is-active-path.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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