@flood-md/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleg (tillwithered)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @flood-md/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Original Flood components for React 18.3/19 and Next.js.
+
+```tsx
+import "@flood-md/react/styles.css";
+import { Button, Field, Input } from "@flood-md/react";
+```
+
+Exports: Button, Input, Textarea, Checkbox, Radio, Switch, Field, Link and their
+TypeScript prop types. Button variants: solid/outline/ghost; sizes: sm/md.
+Loading buttons disable activation. Choice components require a visible label.
+Field uses a function child: `{props => <Input {...props} />}` to wire label and
+description associations. Compose Field in a client component in Next.js.
+
+Import CSS once in Next app/layout.tsx. Add `"use client"` to host components with
+callbacks/state. Override semantic --flood-* variables after the CSS import.
+Native HTML props and refs are forwarded. No Tailwind or third-party UI dependency.

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { type ButtonHTMLAttributes, type InputHTMLAttributes, type TextareaHTMLAttributes, type AnchorHTMLAttributes, type ReactNode } from "react";
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: "solid" | "outline" | "ghost";
+    size?: "sm" | "md";
+    loading?: boolean;
+}
+export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
+    invalid?: boolean;
+}
+export declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<HTMLInputElement>>;
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    invalid?: boolean;
+}
+export declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export interface ChoiceProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    label: ReactNode;
+}
+export declare const Checkbox: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
+export declare const Radio: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
+export declare const Switch: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
+export interface FieldControlProps {
+    id: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: true;
+}
+export interface FieldProps {
+    id?: string;
+    label: ReactNode;
+    hint?: ReactNode;
+    error?: ReactNode;
+    children: (props: FieldControlProps) => ReactNode;
+}
+export declare function Field({ id: explicitId, label, hint, error, children, }: FieldProps): import("react").JSX.Element;
+export declare const Link: import("react").ForwardRefExoticComponent<AnchorHTMLAttributes<HTMLAnchorElement> & import("react").RefAttributes<HTMLAnchorElement>>;

package/dist/index.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useId, } from "react";
+const classes = (...values) => values.filter(Boolean).join(" ");
+export const Button = forwardRef(function Button({ variant = "solid", size = "md", loading = false, disabled, type = "button", className, children, ...props }, ref) {
+    return (_jsxs("button", { ...props, ref: ref, type: type, disabled: disabled || loading, "aria-busy": loading || undefined, className: classes("flood-button", `flood-button--${variant}`, `flood-button--${size}`, className), children: [loading && _jsx("span", { className: "flood-spinner", "aria-hidden": "true" }), children] }));
+});
+export const Input = forwardRef(function Input({ invalid, className, ...props }, ref) {
+    return (_jsx("input", { ...props, ref: ref, "aria-invalid": invalid || props["aria-invalid"], className: classes("flood-input", className) }));
+});
+export const Textarea = forwardRef(function Textarea({ invalid, className, ...props }, ref) {
+    return (_jsx("textarea", { ...props, ref: ref, "aria-invalid": invalid || props["aria-invalid"], className: classes("flood-input", "flood-textarea", className) }));
+});
+export const Checkbox = forwardRef(function Checkbox({ label, className, ...props }, ref) {
+    return (_jsxs("label", { className: classes("flood-choice", className), children: [_jsx("input", { ...props, ref: ref, type: "checkbox", className: "flood-check" }), _jsx("span", { children: label })] }));
+});
+export const Radio = forwardRef(function Radio({ label, className, ...props }, ref) {
+    return (_jsxs("label", { className: classes("flood-choice", className), children: [_jsx("input", { ...props, ref: ref, type: "radio", className: "flood-check" }), _jsx("span", { children: label })] }));
+});
+export const Switch = forwardRef(function Switch({ label, className, ...props }, ref) {
+    return (_jsxs("label", { className: classes("flood-choice", "flood-switch", className), children: [_jsx("span", { children: label }), _jsx("input", { ...props, ref: ref, type: "checkbox", role: "switch", className: "flood-switch-input" })] }));
+});
+export function Field({ id: explicitId, label, hint, error, children, }) {
+    const generatedId = useId();
+    const id = explicitId ?? `flood-${generatedId}`;
+    const description = [hint && `${id}-hint`, error && `${id}-error`].filter(Boolean).join(" ") ||
+        undefined;
+    return (_jsxs("div", { className: "flood-field", children: [_jsx("label", { className: "flood-label", htmlFor: id, children: label }), children({
+                id,
+                "aria-describedby": description,
+                "aria-invalid": error ? true : undefined,
+            }), hint && (_jsx("div", { id: `${id}-hint`, className: "flood-hint", children: hint })), error && (_jsx("div", { id: `${id}-error`, className: "flood-error", role: "alert", children: error }))] }));
+}
+export const Link = forwardRef(function Link({ className, ...props }, ref) {
+    return (_jsx("a", { ...props, ref: ref, className: classes("flood-link", className) }));
+});

package/dist/styles.css

@@ -0,0 +1,191 @@
+@import "@flood-md/tokens/tokens.css";
+
+:where(.flood-button, .flood-input, .flood-choice, .flood-field, .flood-link) {
+  box-sizing: border-box;
+  font-family: var(--flood-font-sans);
+  font-size: var(--flood-text-sm);
+  line-height: 1.45;
+}
+:where(
+  .flood-button,
+  .flood-input,
+  .flood-check,
+  .flood-switch-input,
+  .flood-link
+):focus-visible {
+  outline: 2px solid var(--flood-focus);
+  outline-offset: 3px;
+}
+.flood-button {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  gap: var(--flood-space-2);
+  min-height: var(--flood-control-height);
+  padding: 8px 16px;
+  border: 1px solid transparent;
+  border-radius: var(--flood-radius-md);
+  font-weight: 500;
+  cursor: pointer;
+  transition: opacity var(--flood-duration);
+}
+.flood-button--solid {
+  background: var(--flood-action);
+  color: var(--flood-action-text);
+}
+.flood-button--outline {
+  border-color: var(--flood-border);
+  background: var(--flood-surface);
+  color: var(--flood-text);
+}
+.flood-button--ghost {
+  background: transparent;
+  color: var(--flood-text);
+}
+.flood-button--sm {
+  min-height: 32px;
+  padding: 4px 12px;
+}
+.flood-button--solid:hover:not(:disabled) {
+  opacity: 0.86;
+}
+.flood-button--outline:hover:not(:disabled),
+.flood-button--ghost:hover:not(:disabled) {
+  background: var(--flood-surface-hover);
+}
+.flood-button:disabled {
+  cursor: not-allowed;
+  background: var(--flood-disabled);
+  color: var(--flood-disabled-text);
+}
+.flood-input {
+  width: 100%;
+  min-height: var(--flood-control-height);
+  padding: 9px 12px;
+  border: 1px solid var(--flood-border);
+  border-radius: var(--flood-radius-md);
+  background: var(--flood-surface);
+  color: var(--flood-text);
+}
+.flood-input::placeholder {
+  color: var(--flood-muted);
+}
+.flood-input[aria-invalid="true"] {
+  border-color: var(--flood-danger);
+}
+.flood-input:disabled {
+  background: var(--flood-disabled);
+  color: var(--flood-disabled-text);
+  cursor: not-allowed;
+}
+.flood-textarea {
+  min-height: 96px;
+  resize: vertical;
+}
+.flood-choice {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--flood-space-2);
+  min-height: var(--flood-control-height);
+  color: var(--flood-text);
+  cursor: pointer;
+}
+.flood-choice:has(input:disabled) {
+  cursor: not-allowed;
+  color: var(--flood-disabled-text);
+}
+.flood-check {
+  margin: 0;
+  width: 18px;
+  height: 18px;
+  flex-shrink: 0;
+  accent-color: var(--flood-action);
+  cursor: inherit;
+}
+.flood-switch {
+  justify-content: space-between;
+  gap: var(--flood-space-6);
+}
+.flood-switch-input {
+  appearance: none;
+  flex-shrink: 0;
+  width: 36px;
+  height: 22px;
+  margin: 0;
+  padding: 2px;
+  border: 1px solid var(--flood-border);
+  border-radius: 999px;
+  background: var(--flood-surface-hover);
+  cursor: inherit;
+}
+.flood-switch-input::before {
+  content: "";
+  display: block;
+  width: 16px;
+  height: 16px;
+  border-radius: 50%;
+  background: var(--flood-muted);
+  transition: transform var(--flood-duration);
+}
+.flood-switch-input:checked {
+  background: var(--flood-action);
+  border-color: var(--flood-action);
+}
+.flood-switch-input:checked::before {
+  transform: translateX(14px);
+  background: var(--flood-action-text);
+}
+.flood-switch-input:disabled {
+  opacity: 0.6;
+}
+.flood-field {
+  display: grid;
+  gap: var(--flood-space-2);
+}
+.flood-label {
+  font-weight: 500;
+  color: var(--flood-text);
+}
+.flood-hint {
+  color: var(--flood-muted);
+  font-size: var(--flood-text-xs);
+}
+.flood-error {
+  color: var(--flood-danger);
+  font-size: var(--flood-text-xs);
+}
+.flood-link {
+  color: var(--flood-text);
+  text-underline-offset: 4px;
+  text-decoration-thickness: 1px;
+}
+.flood-spinner {
+  width: 12px;
+  height: 12px;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  border-radius: 50%;
+  animation: flood-spin 0.7s linear infinite;
+}
+@keyframes flood-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .flood-spinner {
+    animation: none;
+  }
+  .flood-switch-input::before,
+  .flood-button {
+    transition: none;
+  }
+}
+@media (forced-colors: active) {
+  .flood-switch-input {
+    appearance: auto;
+  }
+  .flood-switch-input::before {
+    display: none;
+  }
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@flood-md/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Original Flood components for React and Next.js.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tillwithered/flood.md.git",
+    "directory": "packages/react"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "peerDependencies": {
+    "react": "^18.3.0 || ^19.0.0",
+    "react-dom": "^18.3.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@flood-md/tokens": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}