@code-sherpas/pharos-react 0.2.1 → 0.3.0

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

@@ -0,0 +1,35 @@
+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;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+type ButtonVariantProps = VariantProps<typeof buttonVariants>;
+/**
+ * Props accepted by `<Button>`. Extends Base UI's `useRender.ComponentProps<'button'>`,
+ * which means the component accepts every native `<button>` attribute plus the
+ * `render` prop for composition:
+ *
+ * ```tsx
+ * // Render as a router link (inherits all Button styles and behavior):
+ * <Button render={<Link to="/dashboard" />}>Dashboard</Button>
+ * // Or as a function receiving props + state:
+ * <Button render={(props) => <a {...props} href="/x" />}>External</Button>
+ * ```
+ */
+export interface ButtonProps extends useRender.ComponentProps<'button'>, ButtonVariantProps {
+}
+export declare function Button({ render, className, intent, size, type, ref, ...rest }: ButtonProps): import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>>;
+export declare namespace Button {
+    var displayName: string;
+}
+export { buttonVariants };
+//# sourceMappingURL=Button.d.ts.map

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

@@ -0,0 +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;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/components/PharosHello.d.ts

@@ -0,0 +1,6 @@
+import { HTMLAttributes } from 'react';
+export interface PharosHelloProps extends HTMLAttributes<HTMLDivElement> {
+    name?: string;
+}
+export declare function PharosHello({ name, className, ...rest }: PharosHelloProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PharosHello.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PharosHello.d.ts","sourceRoot":"","sources":["../../src/components/PharosHello.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAI5C,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAc,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,2CAMnF"}

package/dist/index.d.ts

@@ -1 +1,6 @@
-export { }
+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

@@ -0,0 +1 @@
+{"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,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC"}