@kanzo-tech/ui 0.0.1-alpha

package/dist/composites/MadeWith.d.ts

@@ -0,0 +1,39 @@
+import { ReactNode } from 'react';
+export interface MadeWithProps {
+    /**
+     * Where the brand points. Omit for a plain, unlinked line.
+     *
+     * There is no `linkComponent`: a router reaches the anchor through `asChild` on
+     * `Link`, which works on every part rather than the one a prop was wired to. A
+     * caller with a routed anchor composes the line itself — it is four elements.
+     */
+    href?: string;
+    /** Words before the heart. Replace to translate. */
+    prefix?: string;
+    /** Words between the heart and the brand. Replace to translate. */
+    infix?: string;
+    /** Accessible name for the heart — it is read aloud, so it is a word, not a glyph. */
+    loveLabel?: string;
+    className?: string;
+    /** The brand. Required, and children rather than a prop: it is markup. */
+    children: ReactNode;
+}
+/**
+ * "Made with ♥ at <brand>" — an attribution line, styled once.
+ *
+ * **Re-admitted after deletion, and narrower than what was deleted.** `396bfd7`
+ * removed the original with a charge worth keeping in view: it "hard-coded the
+ * English 'Made with' and defaulted `by` to 'Kanzo', a brand name in a library
+ * whose first admission rule is domain-freedom". Both are gone. The brand is
+ * children and has no default, so the library names nobody; the two English words
+ * are props with English defaults, which is a convenience a caller can translate
+ * rather than a domain the component carries. It also drops `linkComponent`, the
+ * routing seam that went with `composites/link.tsx`.
+ *
+ * *What would reverse this:* a second product finding the sentence shape wrong —
+ * a different word order, a brand that is not at the end, a line that needs two
+ * links. At that point this is a layout with one arrangement pretending to be a
+ * component, and the honest answer is that four elements are cheap to write.
+ */
+export declare function MadeWith({ href, prefix, infix, loveLabel, className, children, }: MadeWithProps): import("react").JSX.Element;
+//# sourceMappingURL=MadeWith.d.ts.map

package/dist/composites/MadeWith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MadeWith.d.ts","sourceRoot":"","sources":["../../src/composites/MadeWith.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,MAAoB,EACpB,KAAY,EACZ,SAAkB,EAClB,SAAS,EACT,QAAQ,GACT,EAAE,aAAa,+BAYf"}

package/dist/composites/MadeWith.js

@@ -0,0 +1,30 @@
+import { jsxs as s, jsx as t } from "react/jsx-runtime";
+import { HeartIcon as n } from "lucide-react";
+import { cn as l } from "../lib/cn.js";
+import { Link as d } from "../simples/Link.js";
+function u({
+  href: e,
+  prefix: i = "Made with",
+  infix: o = "at",
+  loveLabel: a = "love",
+  className: m,
+  children: r
+}) {
+  return /* @__PURE__ */ s(
+    "p",
+    {
+      "data-slot": "made-with",
+      className: l("inline-flex items-center gap-1 text-muted-foreground text-xs", m),
+      children: [
+        i,
+        /* @__PURE__ */ t(n, { role: "img", "aria-label": a, className: "size-3.5 fill-destructive text-destructive" }),
+        o,
+        e ? /* @__PURE__ */ t(d, { href: e, children: r }) : /* @__PURE__ */ t("span", { className: "font-medium text-foreground", children: r })
+      ]
+    }
+  );
+}
+export {
+  u as MadeWith
+};
+//# sourceMappingURL=MadeWith.js.map

package/dist/composites/MadeWith.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MadeWith.js","sources":["../../src/composites/MadeWith.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { HeartIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { Link } from \"../simples/Link\";\n\nexport interface MadeWithProps {\n  /**\n   * Where the brand points. Omit for a plain, unlinked line.\n   *\n   * There is no `linkComponent`: a router reaches the anchor through `asChild` on\n   * `Link`, which works on every part rather than the one a prop was wired to. A\n   * caller with a routed anchor composes the line itself — it is four elements.\n   */\n  href?: string;\n  /** Words before the heart. Replace to translate. */\n  prefix?: string;\n  /** Words between the heart and the brand. Replace to translate. */\n  infix?: string;\n  /** Accessible name for the heart — it is read aloud, so it is a word, not a glyph. */\n  loveLabel?: string;\n  className?: string;\n  /** The brand. Required, and children rather than a prop: it is markup. */\n  children: ReactNode;\n}\n\n/**\n * \"Made with ♥ at <brand>\" — an attribution line, styled once.\n *\n * **Re-admitted after deletion, and narrower than what was deleted.** `396bfd7`\n * removed the original with a charge worth keeping in view: it \"hard-coded the\n * English 'Made with' and defaulted `by` to 'Kanzo', a brand name in a library\n * whose first admission rule is domain-freedom\". Both are gone. The brand is\n * children and has no default, so the library names nobody; the two English words\n * are props with English defaults, which is a convenience a caller can translate\n * rather than a domain the component carries. It also drops `linkComponent`, the\n * routing seam that went with `composites/link.tsx`.\n *\n * *What would reverse this:* a second product finding the sentence shape wrong —\n * a different word order, a brand that is not at the end, a line that needs two\n * links. At that point this is a layout with one arrangement pretending to be a\n * component, and the honest answer is that four elements are cheap to write.\n */\nexport function MadeWith({\n  href,\n  prefix = \"Made with\",\n  infix = \"at\",\n  loveLabel = \"love\",\n  className,\n  children,\n}: MadeWithProps) {\n  return (\n    <p\n      data-slot=\"made-with\"\n      className={cn(\"inline-flex items-center gap-1 text-muted-foreground text-xs\", className)}\n    >\n      {prefix}\n      <HeartIcon role=\"img\" aria-label={loveLabel} className=\"size-3.5 fill-destructive text-destructive\" />\n      {infix}\n      {href ? <Link href={href}>{children}</Link> : <span className=\"font-medium text-foreground\">{children}</span>}\n    </p>\n  );\n}\n"],"names":["MadeWith","href","prefix","infix","loveLabel","className","children","jsxs","cn","HeartIcon","jsx","Link"],"mappings":";;;;AA0CO,SAASA,EAAS;AAAA,EACvB,MAAAC;AAAA,EACA,QAAAC,IAAS;AAAA,EACT,OAAAC,IAAQ;AAAA,EACR,WAAAC,IAAY;AAAA,EACZ,WAAAC;AAAA,EACA,UAAAC;AACF,GAAkB;AAChB,SACE,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,aAAU;AAAA,MACV,WAAWC,EAAG,gEAAgEH,CAAS;AAAA,MAEtF,UAAA;AAAA,QAAAH;AAAA,0BACAO,GAAA,EAAU,MAAK,OAAM,cAAYL,GAAW,WAAU,8CAA6C;AAAA,QACnGD;AAAA,QACAF,IAAO,gBAAAS,EAACC,GAAA,EAAK,MAAAV,GAAa,UAAAK,EAAA,CAAS,IAAU,gBAAAI,EAAC,QAAA,EAAK,WAAU,+BAA+B,UAAAJ,EAAA,CAAS;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAG5G;"}

package/dist/composites/Preferences.d.ts

@@ -0,0 +1,155 @@
+import { Appearance } from '@kanzo-tech/theme';
+import * as React from "react";
+export interface PreferencesRootProps {
+    children: React.ReactNode;
+    /**
+     * Key that toggles the panel, e.g. `"t"`. **Opt-in — there is no default.**
+     *
+     * When set, this registers a `window` keydown listener that fires on the bare key (typing in
+     * an input, textarea or contenteditable is ignored). A design system must not claim a
+     * single, unmodified key in its host's global keymap without being asked, so omit this
+     * unless the host has decided that key is free.
+     */
+    hotkey?: string;
+    defaultOpen?: boolean;
+}
+declare function PreferencesRoot({ children, hotkey, defaultOpen }: PreferencesRootProps): React.JSX.Element;
+declare function PreferencesTrigger({ className }: {
+    className?: string;
+}): React.JSX.Element;
+declare function PreferencesPanel({ children, title, hint, }: {
+    children?: React.ReactNode;
+    title?: string;
+    hint?: string;
+}): React.JSX.Element;
+/**
+ * A titled preferences row. This used to be a bare `<div>` plus a hand-rolled `GroupTitle` —
+ * fixed typography, no `htmlFor`, no association with the control it titled, and in the
+ * segmented cases the label was written TWICE (once visibly, once as `aria-label`).
+ *
+ * `Field` is precisely this, wired: it generates the id, connects the label to the control and
+ * carries the state by context. The forms guide says so; the library's own flagship composite
+ * was the one place not taking its own advice.
+ */
+declare function PrefField({ label, children }: {
+    label: React.ReactNode;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * A titled GROUP of options — the container `PrefField` cannot be.
+ *
+ * `Field` addresses one control, and a radio group has one hidden input per item, so there is no
+ * id for its label to point at; `radio-group.tsx` says exactly this, and says `FieldSet` +
+ * `FieldLegend` is the answer.
+ *
+ * The legend really is the name, not a decoration beside one: Ark's `useRadioGroup` passes
+ * `ids: { label: fieldset.ids.legend }` into the machine, and zag's root props set
+ * `aria-labelledby` from it.
+ */
+declare function PrefFieldSet({ label, children }: {
+    label: React.ReactNode;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * COLOUR — every choice the tenant published, as one list.
+ *
+ * **A palette and an identity are one abstraction with a parameter: how much of the document the
+ * choice replaces.** An identity replaces the brand-derived slice and inherits every surface; a
+ * palette replaces all of it. They always shared this control, this option type, the hide-below-two
+ * rule and the retirement machinery — and the giveaway was the behaviour: changing palette *files and
+ * restores* the identity, which is what containment does and what two sibling axes never would.
+ *
+ * So the panel shows one list. A palette that publishes several brands contributes one entry per
+ * brand — `Bank · Retail`, `Bank · Private` — which is how VS Code and Slack present variants, and
+ * which matches what the user is actually doing: making one choice. The model keeps the containment,
+ * because that is what guarantees a tenant's brands share a neutral and stay one product.
+ *
+ * The prefix appears only when there is more than one palette to disambiguate against: a client with
+ * a single palette and two brands sees `Retail` and `Private`, not their own name twice.
+ */
+export interface PreferencesColorProps {
+    /** The legend, and one of the section's two library-authored strings (i18n). */
+    label?: string;
+    /** Heading of the notice shown when the tenant withdrew what this user had chosen. */
+    retiredTitle?: string;
+    /** Compose that notice's body. The argument is the retired **id**; its label went with it. */
+    formatRetired?: (parts: {
+        choice: string;
+    }) => string;
+    /** Name a side. The section's third and last library-authored string (i18n). */
+    formatSide?: (side: Appearance) => string;
+}
+declare function ColorSection({ label, retiredTitle, formatRetired, formatSide, }?: PreferencesColorProps): React.JSX.Element | null;
+/**
+ * Whatever the packages this host installed contribute — one group per declared preference.
+ *
+ * **Nothing here names a package.** The host registers manifests on the provider, the provider
+ * resolves them, and this renders what it is handed; `@kanzo-tech/ui` gains no reference to
+ * `@kanzo-tech/graph` and a host that never installed it passes nothing and draws nothing.
+ *
+ * Three things it declines to draw, each for a reason that belongs to the section rather than to the
+ * panel: a preference a tenant **pinned** or **withheld** (`offered` is false, and the two are the
+ * same instruction here for different reasons upstream), and a namespace whose manifest declares
+ * only tokens. That last one is filtered in the provider, so an empty legend cannot reach the DOM.
+ *
+ * A contributed preference gets `RadioGroupCard` and not something new, because the choice it
+ * expresses is the one `Colour` and `Density` already express — pick one of these, they have names.
+ */
+export interface PreferencesSectionsProps {
+    /**
+     * Draw one namespace instead of all of them.
+     *
+     * **This is what makes a preference one thing with several surfaces.** A panel wants every
+     * contributed section; a dock inside a canvas wants the graph's and nothing else; a settings page
+     * may want them under its own headings. Without it a surface that is not the panel has to
+     * hand-roll the controls — which is how the workspace's dock came to hold its own copy of the
+     * graph's appearance in React state, a second store for a preference the provider was already
+     * resolving.
+     *
+     * The namespace is the section's own — `"graph"` — and an unknown one draws nothing rather than
+     * throwing: a host that removed an optional package should lose a control, not a page.
+     */
+    namespace?: string;
+    /**
+     * Draw only these preferences, by name, in this order.
+     *
+     * The third selection, and the one a **dock** needs: a canvas has a panel for the forces and a
+     * panel for the picture, and both are the same section. Without it the surface either draws the
+     * whole section in one place or goes back to hand-rolling — which is the state this mechanism was
+     * built to end, so a selection that stops at the namespace stops one step short.
+     *
+     * Order is the caller's here, where a section's own order is the manifest's. That is the same
+     * split `PreferencesColor` already makes: what to offer belongs to whoever declared it, how to
+     * arrange a page belongs to the page. A name nothing declares draws nothing.
+     */
+    only?: readonly string[];
+}
+declare function ContributedSections({ namespace, only }?: PreferencesSectionsProps): React.JSX.Element;
+declare function RadiusSection(): React.JSX.Element | null;
+declare const FontSection: () => React.JSX.Element;
+declare const MonoFontSection: () => React.JSX.Element;
+declare const DensitySection: () => React.JSX.Element;
+export interface PreferencesProps extends Omit<PreferencesRootProps, "children"> {
+    /** Restyle or reposition the floating trigger (it is `fixed bottom-4 end-4` by default). */
+    triggerClassName?: string;
+}
+/**
+ * All-in-one: a floating trigger + the full drawer.
+ *
+ * Forwards Root's props and lets the trigger be restyled or repositioned — it used to take
+ * none, so a consumer could neither move the FAB nor reach the hotkey.
+ *
+ * There is no `Preferences.Root` / `.Panel` / `.Density` namespace. It was built with
+ * `Object.assign`, and those statics do NOT survive React Server Components: once the module
+ * becomes a client reference, `Preferences.Density` reads back as `undefined` and React throws
+ * "Element type is invalid". It was a broken API kept beside the working one — and it was the
+ * single counter-example to "no component exports dot-notation".
+ */
+export declare function Preferences({ triggerClassName, ...rootProps }?: PreferencesProps): React.JSX.Element;
+/**
+ * The parts as flat named exports — the API. They cross the RSC boundary intact, tree-shake per
+ * part, and match how every other compound in this library is exported (`DialogContent`, not
+ * `Dialog.Content`).
+ */
+export { PreferencesRoot, PreferencesTrigger, PreferencesPanel, PrefField as PreferencesField, PrefFieldSet as PreferencesFieldSet, ColorSection as PreferencesColor, ContributedSections as PreferencesSections, RadiusSection as PreferencesRadius, FontSection as PreferencesFont, MonoFontSection as PreferencesMonoFont, DensitySection as PreferencesDensity, };
+//# sourceMappingURL=Preferences.d.ts.map

package/dist/composites/Preferences.d.ts.map

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