@charcuterie/ui 0.1.0

package/src/testing/index.ts

@@ -0,0 +1,17 @@
+/**
+ * `@charcuterie/ui/testing` — the drivability gates, shipped so
+ * consumers can hold their own components to them.
+ *
+ * A separate entry point rather than part of the barrel: nothing
+ * here belongs in an app's production bundle, and a deep import is
+ * what keeps it out without a build-time trick.
+ */
+
+export type {
+  AgentQueries,
+  AgentTarget,
+} from "./expectAgentDrivable.ts"
+export {
+  expectAgentDrivable,
+  expectHiddenFromAgents,
+} from "./expectAgentDrivable.ts"

package/src/toClassName.ts

@@ -0,0 +1,13 @@
+/**
+ * Filter-and-join. Deliberately not `clsx`.
+ *
+ * Every call site in this package passes a flat list of strings and
+ * conditionals, which is four lines of work — and a published
+ * component library's dependency list is a thing consumers inherit,
+ * so it earns its entries. `clsx` also accepts objects and nested
+ * arrays, both of which make a className harder for the Tailwind
+ * scanner and for `tailwindCandidates.test.ts` to read statically.
+ */
+export const toClassName = (
+  ...parts: (false | string | null | undefined)[]
+) => parts.filter(Boolean).join(" ")

package/src/tokens.ts

@@ -0,0 +1,16 @@
+/**
+ * `@charcuterie/ui/tokens` — the tokens, under the name a React
+ * consumer already has installed.
+ *
+ * The build-graph split between `tokens` and `ui` exists for two
+ * consumers that cannot take a React tree: `castkit/packages/views`
+ * renders through Satori and needs resolved literals, and
+ * `slatecast` has 60 KB gz to spend. Neither should have to install
+ * `@charcuterie/ui` to read a colour.
+ *
+ * That is a build-graph split, **not an API split** — so a React app
+ * importing `@charcuterie/ui` gets the tokens from the same package
+ * name and never has to know the boundary exists.
+ */
+
+export * from "@charcuterie/tokens"