@code-sherpas/pharos-react 0.2.2 → 0.4.0

package/README.md

@@ -2,7 +2,9 @@
 
 React component library for Code Sherpas. Consumes
 [`@code-sherpas/pharos-tokens`](https://github.com/code-sherpas/pharos-tokens)
-as a peer dependency. Built with Vite library mode, React 19, Tailwind v4.
+as a peer dependency. Built with Vite library mode, React 19 and CSS Modules.
+The published bundle ships zero Tailwind, zero PostCSS preflight and zero
+global resets — see Decision D9 in `PLAN-pharos-alexandria.md`.
 
 ## What's in this package
 
@@ -22,15 +24,16 @@ explicitly alongside this package.
 ## Usage
 
 ```ts
-// Root entry file (e.g. main.tsx, app/layout.tsx)
-import '@code-sherpas/pharos-react/styles.css';
+// Root entry file (e.g. main.tsx, app/layout.tsx). Import once.
+import '@code-sherpas/pharos-tokens/css'; // CSS variables for the design tokens
+import '@code-sherpas/pharos-react/styles.css'; // hashed component styles
 ```
 
 ```tsx
-import { PharosHello } from '@code-sherpas/pharos-react';
+import { Button } from '@code-sherpas/pharos-react';
 
 export function Demo() {
-  return <PharosHello name="Alexandria" />;
+  return <Button intent="primary">Save changes</Button>;
 }
 ```
 
@@ -50,7 +53,8 @@ The live component reference runs on Storybook 10 + `@storybook/react-vite`.
 ## Contributing
 
 1. `pnpm install`
-2. Implement the component under `src/components/<Name>.tsx`, export it from
+2. Implement the component under `src/components/<Name>.tsx` plus its
+   sibling `src/components/<Name>.module.css` (Decision D9). Export it from
    `src/index.ts`.
 3. Add a story alongside: `src/components/<Name>.stories.tsx`.
 4. Add tests under `tests/` (Vitest + Testing Library).

package/RULES.md

@@ -38,8 +38,16 @@ canonical one — do not alias.
 import '@code-sherpas/pharos-react/styles.css';
 ```
 
-This loads the compiled Tailwind v4 output plus the `@theme inline` mapping
-to `--pharos-*`. Without it, components render unstyled.
+This loads the compiled CSS Modules output of every component (hashed class
+names that the React components reference at runtime). Without it,
+components render unstyled.
+
+**You do not need Tailwind, PostCSS, or any other CSS framework to consume
+pharos-react** (Decision D9). The published bundle is pure CSS — no
+`@layer` directives, no preflight, no global resets, no class-name
+collisions with your own utilities. It works the same in Next.js + Tailwind
+v3, Next.js + Tailwind v4, Vite + plain CSS, Astro, Remix, or any other
+React stack.
 
 ## 4. `pharos-tokens` is a peer dependency
 

package/dist/components/Button.d.ts

@@ -1,5 +1,13 @@
 import { useRender } from '@base-ui/react/use-render';
 import { VariantProps } from 'class-variance-authority';
+/**
+ * Maps the two public variant axes (`intent`, `size`) to the per-class names
+ * inside `Button.module.css`. CVA stays as the typed-variants mechanism
+ * (Decision D9 keeps the authoring DX) but each value points at a hashed
+ * CSS Modules class instead of a Tailwind utility string. The base class
+ * carries layout, typography and the focus-visible ring — every variant
+ * stacks on top of it.
+ */
 declare const buttonVariants: (props?: ({
     intent?: "primary" | "secondary" | "ghost" | "destructive" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;

package/dist/components/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../src/components/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,cAAc;;;8EAsDnB,CAAC;AAEF,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,kBAAkB;CAAG;AAE9F,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,SAAS,EACT,MAAM,EACN,IAAI,EACJ,IAAe,EACf,GAAG,EACH,GAAG,IAAI,EACR,EAAE,WAAW,8FAWb;yBAnBe,MAAM;;;AAuBtB,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../src/components/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc;;;8EAwBlB,CAAC;AAEH,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,kBAAkB;CAAG;AAE9F,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,SAAS,EACT,MAAM,EACN,IAAI,EACJ,IAAe,EACf,GAAG,EACH,GAAG,IAAI,EACR,EAAE,WAAW,8FAmBb;yBA3Be,MAAM;;;AA+BtB,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,4 @@
 export { Button, buttonVariants } from './components/Button';
 export type { ButtonProps } from './components/Button';
-export { PharosHello } from './components/PharosHello';
-export type { PharosHelloProps } from './components/PharosHello';
 export { cn } from './lib/cn';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC"}