@liketysplit/react-luna 0.1.5 → 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,14 +1,19 @@
+export * from "./luna-avatar";
 export * from "./luna-button";
 export * from "./luna-card";
 export * from "./luna-checkbox";
+export * from "./luna-date-input";
+export * from "./luna-date-picker";
 export * from "./luna-radio";
 export * from "./luna-divider";
 export * from "./luna-header";
 export * from "./luna-input";
+export * from "./luna-slider";
 export * from "./luna-textarea";
 export * from "./luna-select";
 export * from "./luna-multiselect";
 export * from "./luna-autocomplete";
+export * from "./luna-switch";
 export * from "./luna-text";
 export * from "./luna-row";
 export * from "./luna-column";

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

@@ -0,0 +1,10 @@
+import React from "react";
+import "./LunaDateInput.css";
+export declare const LunaDateInput: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "type"> & {
+    label?: React.ReactNode;
+    externalLabel?: boolean;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+    inputSize?: "sm" | "md" | "lg";
+    fullWidth?: boolean;
+} & React.RefAttributes<HTMLInputElement>>;

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

@@ -0,0 +1,9 @@
+import type React from "react";
+export type LunaDateInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "prefix" | "size" | "type"> & {
+    label?: React.ReactNode;
+    externalLabel?: boolean;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+    inputSize?: "sm" | "md" | "lg";
+    fullWidth?: boolean;
+};

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

@@ -0,0 +1,2 @@
+export * from "./LunaDateInput";
+export type { LunaDateInputProps } from "./LunaDateInput.props";

package/dist/components/luna-date-picker/LunaDatePicker.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { LunaDatePickerProps } from "./LunaDatePicker.props";
+import "./LunaDatePicker.css";
+export declare const LunaDatePicker: React.ForwardRefExoticComponent<LunaDatePickerProps & React.RefAttributes<HTMLInputElement>>;

package/dist/components/luna-date-picker/LunaDatePicker.props.d.ts

@@ -0,0 +1,28 @@
+import type React from "react";
+export type LunaDateRangeValue = {
+    start?: string;
+    end?: string;
+};
+type LunaDatePickerBaseProps = {
+    label?: React.ReactNode;
+    externalLabel?: boolean;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+    inputSize?: "sm" | "md" | "lg";
+    fullWidth?: boolean;
+    buttonPosition?: "pre" | "post";
+};
+type LunaDatePickerSimpleOrPickerProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "prefix" | "size" | "type" | "value" | "defaultValue" | "onChange"> & LunaDatePickerBaseProps & {
+    mode?: "simple" | "picker";
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+};
+type LunaDatePickerRangeProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "prefix" | "size" | "type" | "value" | "defaultValue" | "onChange"> & LunaDatePickerBaseProps & {
+    mode: "range";
+    value?: LunaDateRangeValue;
+    defaultValue?: LunaDateRangeValue;
+    onChange?: (value: LunaDateRangeValue) => void;
+};
+export type LunaDatePickerProps = LunaDatePickerSimpleOrPickerProps | LunaDatePickerRangeProps;
+export {};

package/dist/components/luna-date-picker/dateUtils.d.ts

@@ -0,0 +1,19 @@
+import type { LunaDateRangeValue } from "./LunaDatePicker.props";
+export declare function parseDateValue(value?: string): Date | null;
+export declare function formatDateValue(date: Date): string;
+export declare function formatInputDate(value?: string): string;
+export declare function parseInputDate(value?: string): string | null;
+export declare function formatDisplayDate(value?: string): string;
+export declare function formatDisplayRange(value?: LunaDateRangeValue): string;
+export declare function startOfMonth(date: Date): Date;
+export declare function addMonths(date: Date, amount: number): Date;
+export declare function isSameDay(left: Date | null, right: Date | null): boolean;
+export declare function isBeforeDay(left: Date | null, right: Date | null): boolean;
+export declare function isInRange(date: Date, start: Date | null, end: Date | null): boolean;
+export declare function isOutsideLimits(date: Date, min?: string, max?: string): boolean;
+export declare function buildMonthGrid(visibleMonth: Date): {
+    date: Date;
+    value: string;
+    day: number;
+    inMonth: boolean;
+}[];

package/dist/components/luna-date-picker/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./LunaDatePicker";
+export type { LunaDatePickerProps, LunaDateRangeValue } from "./LunaDatePicker.props";

package/dist/components/luna-slider/LunaSlider.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import "./LunaSlider.css";
+export declare const LunaSlider: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "type"> & {
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+    showValue?: boolean;
+} & React.RefAttributes<HTMLInputElement>>;

package/dist/components/luna-slider/LunaSlider.props.d.ts

@@ -0,0 +1,8 @@
+import type React from "react";
+export type LunaSliderProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "type"> & {
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+    showValue?: boolean;
+};

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

@@ -0,0 +1,2 @@
+export * from "./LunaSlider";
+export type { LunaSliderProps } from "./LunaSlider.props";

package/dist/components/luna-switch/LunaSwitch.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import "./LunaSwitch.css";
+export declare const LunaSwitch: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "type"> & {
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+} & React.RefAttributes<HTMLInputElement>>;

package/dist/components/luna-switch/LunaSwitch.props.d.ts

@@ -0,0 +1,7 @@
+import type React from "react";
+export type LunaSwitchProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "size" | "type"> & {
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    helpText?: React.ReactNode;
+    error?: React.ReactNode;
+};

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

@@ -0,0 +1,2 @@
+export * from "./LunaSwitch";
+export type { LunaSwitchProps } from "./LunaSwitch.props";