@liketysplit/react-luna 0.1.6 → 0.2.0

package/README.md

@@ -3,11 +3,18 @@
 Statement
 @liketysplit/react-luna is a self-sufficient React component library designed to be a durable foundation for personal applications. It targets a clean, lunar aesthetic with a default light and dark theme that can be overridden at the project level after installation.
 
+Current direction:
+- treat themeability as a first-class requirement
+- use `LunaButton` as the baseline contract example for primitive quality
+- keep primitives durable enough that downstream projects can make the library feel like their own
+
 Goals
 - Provide a complete set of reusable UI primitives and layouts.
 - Keep the library independent from third-party UI frameworks.
 - Ship a default Lunar theme with light and dark variants.
 - Allow downstream projects to override theme tokens and component styling.
+- Harden component contracts before broadening surface area.
+- Keep Storybook, tests, and public docs aligned with meaningful component changes.
 
 Non-goals
 - Depending on external UI component libraries.
@@ -16,12 +23,25 @@ Design Approach
 - Theme tokens first, component styles derived from tokens.
 - Accessible defaults and consistent spacing/typography scales.
 - Clear layering of primitives, composites, and templates.
+- Primitive contracts should be small, explicit, and durable.
+- `LunaButton` is the proving ground for contract quality and theme extensibility.
 
 Tooling
 - React for component implementation.
 - Storybook for interactive component exploration and configuration.
 - Changesets for package versioning and release notes.
 
+Working Model
+- Use GitHub Issues as the active backlog.
+- Keep repository docs aligned with the actual issue and milestone direction.
+- Treat implementation, Storybook, tests, and docs as one delivery slice when behavior changes.
+
+Roadmap Shape
+- `docs/ROADMAP.md` records the release-shape north star.
+- `0.0.x` is for building the needed component base.
+- `0.x.x` is for hardening the library.
+- `1.1.x` is for building a real app with the library and correcting flaws found through actual use.
+
 Release Flow
 - Add a changeset with `npm run changeset` for any package change that should affect the published version.
 - Merge to `main`.

package/dist/components/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./luna-avatar";
 export * from "./luna-button";
 export * from "./luna-card";
 export * from "./luna-checkbox";

package/dist/components/luna-avatar/LunaAvatar.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import "./LunaAvatar.css";
+export declare const LunaAvatar: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children" | "color"> & {
+    as?: React.ElementType;
+    src?: string;
+    alt?: string;
+    name?: string;
+    initials?: string;
+    fallback?: React.ReactNode;
+    size?: string;
+} & React.RefAttributes<HTMLElement>>;

package/dist/components/luna-avatar/LunaAvatar.props.d.ts

@@ -0,0 +1,10 @@
+import type React from "react";
+export type LunaAvatarProps = Omit<React.HTMLAttributes<HTMLElement>, "children" | "color"> & {
+    as?: React.ElementType;
+    src?: string;
+    alt?: string;
+    name?: string;
+    initials?: string;
+    fallback?: React.ReactNode;
+    size?: string;
+};

package/dist/components/luna-avatar/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./LunaAvatar";
+export * from "./LunaAvatar.props";

package/dist/components/luna-date-input/LunaDateInput.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import "./LunaDateInput.css";
-export declare const LunaDateInput: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "type" | "prefix"> & {
+export declare const LunaDateInput: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "type"> & {
     label?: React.ReactNode;
     externalLabel?: boolean;
     helpText?: React.ReactNode;