@idyeah/diya 0.0.0 → 1.0.1

package/dist/workflow/FileUpload.js

@@ -0,0 +1,47 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useRef, useState } from 'react';
+import { Button } from '../button/Button.js';
+import { Icon } from '../Icon.js';
+import { useDiyaLocale, useDiyaMessages } from '../DiyaProvider.js';
+import { cx } from '../internal/cx.js';
+import { fileUploadMessages } from './file-upload-messages.js';
+/** A drop zone and file picker with a removable file list. Selects local files; upload, persistence and server validation belong to the caller. */
+export const FileUpload = forwardRef(function FileUpload({ files, onFilesChange, accept = '', maxBytes, multiple = false, disabled = false, title: titleProp, headingLevel = 3, description: descriptionProp, helperText, chooseLabel, onReject, className, ...props }, ref) {
+    const t = useDiyaMessages('fileUpload', fileUploadMessages);
+    const locale = useDiyaLocale();
+    const title = titleProp ?? t.title;
+    const Heading = `h${headingLevel}`;
+    const description = descriptionProp === undefined ? t.description : descriptionProp;
+    const picker = useRef(null);
+    const chooseButton = useRef(null);
+    const [error, setError] = useState('');
+    const [dragging, setDragging] = useState(false);
+    const rules = accept.split(',').map(rule => rule.trim().toLowerCase()).filter(Boolean);
+    function add(incoming) {
+        if (!incoming || disabled)
+            return;
+        const accepted = [];
+        const rejected = [];
+        for (const file of Array.from(incoming)) {
+            const name = file.name.toLowerCase();
+            const mime = file.type.toLowerCase();
+            const matches = !rules.length || rules.some(rule => rule.startsWith('.') ? name.endsWith(rule) : rule.endsWith('/*') ? mime.startsWith(rule.slice(0, -1)) : mime === rule);
+            if (!matches)
+                rejected.push({ file, reason: 'type' });
+            else if (maxBytes !== undefined && Number.isFinite(maxBytes) && maxBytes >= 0 && file.size > maxBytes)
+                rejected.push({ file, reason: 'size' });
+            else
+                accepted.push(file);
+        }
+        if (accepted.length) {
+            const next = multiple ? [...files, ...accepted].filter((file, index, all) => all.findIndex(other => other.name === file.name && other.size === file.size && other.lastModified === file.lastModified) === index) : accepted.slice(0, 1);
+            onFilesChange(next);
+        }
+        setError(rejected.length ? t.rejected(rejected.length) : '');
+        if (rejected.length)
+            onReject?.(rejected);
+    }
+    return _jsxs("section", { ...props, ref: ref, className: cx('diya-workflow-surface diya-upload', className), "aria-label": title, "aria-disabled": disabled || undefined, children: [_jsxs("div", { className: "diya-upload-drop", "data-dragging": dragging || undefined, onDragOver: event => { event.preventDefault(); if (!disabled)
+                    setDragging(true); }, onDragLeave: () => setDragging(false), onDrop: event => { event.preventDefault(); setDragging(false); add(event.dataTransfer.files); }, children: [_jsx("span", { className: "diya-workflow-symbol", children: _jsx("svg", { width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.6", "aria-hidden": "true", children: _jsx("path", { d: "M12 16V3m-5 5 5-5 5 5M4 15v6h16v-6" }) }) }), _jsx(Heading, { className: "diya-upload-title", children: title }), description && _jsx("p", { children: description }), _jsx(Button, { ref: chooseButton, variant: "outline", disabled: disabled, onClick: () => picker.current?.click(), children: chooseLabel ?? t.choose }), _jsx("input", { ref: picker, type: "file", hidden: true, disabled: disabled, accept: accept || undefined, multiple: multiple, onChange: event => { add(event.target.files); event.target.value = ''; } }), helperText && _jsx("small", { children: helperText })] }), error && _jsx("p", { className: "diya-workflow-error", role: "alert", children: error }), !!files.length && _jsx("ul", { className: "diya-upload-files", children: files.map(file => _jsxs("li", { children: [_jsx("svg", { width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.6", "aria-hidden": "true", children: _jsx("path", { d: "M5 3h9l5 5v13H5V3Zm9 0v6h5" }) }), _jsxs("span", { children: [_jsx("strong", { children: file.name }), _jsx("small", { children: file.size < 1024 * 1024 ? t.kilobytes(Math.max(1, Math.round(file.size / 1024)).toLocaleString(locale, { useGrouping: false })) : t.megabytes((file.size / 1024 / 1024).toLocaleString(locale, { minimumFractionDigits: 1, maximumFractionDigits: 1, useGrouping: false })) })] }), _jsx(Button, { variant: "quiet", iconOnly: true, disabled: disabled, "aria-label": t.remove(file.name), onClick: () => { onFilesChange(files.filter(item => item !== file)); chooseButton.current?.focus(); }, children: _jsx(Icon, { name: "close" }) })] }, `${file.name}-${file.size}-${file.lastModified}`)) }), _jsx("span", { className: "diya-workflow-sr", role: "status", children: t.selected(files.length) })] });
+});

package/dist/workflow/Form.d.ts

@@ -0,0 +1,52 @@
+import { type FormHTMLAttributes, type FormEvent, type ReactNode } from 'react';
+import { formMessages } from './form-messages.js';
+declare module '../messages.js' {
+    interface DiyaMessages {
+        form: typeof formMessages;
+    }
+}
+export type FormProps = Omit<FormHTMLAttributes<HTMLFormElement>, 'title' | 'onSubmit' | 'children'> & {
+    /** Visible heading; it is also the form's accessible name. Leave it out when the page already has a heading, and name the form with `aria-label` instead. */
+    title?: string;
+    /** Heading level of the title, 1–6; defaults to 3. */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Supporting text under the title. */
+    description?: ReactNode;
+    /** The form's fields. */
+    children: ReactNode;
+    /** Replaces the default Cancel and Submit buttons; pass null for no footer. */
+    actions?: ReactNode;
+    /** Called on submit with the event (default already prevented); not called while loading. */
+    onSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    /** Shows a Cancel button that calls this. */
+    onCancel?: () => void;
+    /** Submit button text; defaults to "Submit". */
+    submitLabel?: string;
+    /** Cancel button text; defaults to "Cancel". */
+    cancelLabel?: string;
+    /** Shows a spinner on Submit, disables Cancel and blocks resubmission; defaults to false. */
+    loading?: boolean;
+};
+/** A form with an optional title, Submit and optional Cancel. Composes caller-owned fields and validation; it never invents a successful submission. */
+export declare const Form: import("react").ForwardRefExoticComponent<Omit<FormHTMLAttributes<HTMLFormElement>, "children" | "title" | "onSubmit"> & {
+    /** Visible heading; it is also the form's accessible name. Leave it out when the page already has a heading, and name the form with `aria-label` instead. */
+    title?: string;
+    /** Heading level of the title, 1–6; defaults to 3. */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Supporting text under the title. */
+    description?: ReactNode;
+    /** The form's fields. */
+    children: ReactNode;
+    /** Replaces the default Cancel and Submit buttons; pass null for no footer. */
+    actions?: ReactNode;
+    /** Called on submit with the event (default already prevented); not called while loading. */
+    onSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    /** Shows a Cancel button that calls this. */
+    onCancel?: () => void;
+    /** Submit button text; defaults to "Submit". */
+    submitLabel?: string;
+    /** Cancel button text; defaults to "Cancel". */
+    cancelLabel?: string;
+    /** Shows a spinner on Submit, disables Cancel and blocks resubmission; defaults to false. */
+    loading?: boolean;
+} & import("react").RefAttributes<HTMLFormElement>>;

package/dist/workflow/Form.js

@@ -0,0 +1,16 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useId } from 'react';
+import { Button } from '../button/Button.js';
+import { useDiyaMessages } from '../DiyaProvider.js';
+import { cx } from '../internal/cx.js';
+import { formMessages } from './form-messages.js';
+/** A form with an optional title, Submit and optional Cancel. Composes caller-owned fields and validation; it never invents a successful submission. */
+export const Form = forwardRef(function Form({ title, headingLevel = 3, description, children, actions, onSubmit, onCancel, submitLabel, cancelLabel, loading = false, className, ...props }, ref) {
+    const t = useDiyaMessages('form', formMessages);
+    const id = useId();
+    const Heading = `h${headingLevel}`;
+    const footer = actions === undefined ? _jsxs(_Fragment, { children: [onCancel && _jsx(Button, { variant: "quiet", disabled: loading, onClick: onCancel, children: cancelLabel ?? t.cancel }), _jsx(Button, { type: "submit", loading: loading, children: submitLabel ?? t.submit })] }) : actions;
+    return _jsxs("form", { ...props, ref: ref, className: cx('diya-workflow-surface diya-project-form', className), "aria-labelledby": title ? id : props['aria-labelledby'], "aria-busy": loading || undefined, onSubmit: event => { event.preventDefault(); if (!loading)
+            onSubmit(event); }, children: [(title || description) && _jsxs("header", { children: [title && _jsx(Heading, { id: id, className: "diya-project-form-title", children: title }), description && _jsx("p", { children: description })] }), children, footer && _jsx("footer", { children: footer })] });
+});

package/dist/workflow/Wizard.d.ts

@@ -0,0 +1,76 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { wizardMessages } from './wizard-messages.js';
+declare module '../messages.js' {
+    interface DiyaMessages {
+        wizard: typeof wizardMessages;
+    }
+}
+export type WizardStep = {
+    /** Stable key for the step. */
+    id: string;
+    /** Short name shown in the step list. */
+    label: string;
+    /** Heading above the step's content; defaults to `label`. */
+    title?: string;
+    /** Supporting text under the step heading. */
+    description?: ReactNode;
+    /** The step's fields; plain fields, not a nested form. */
+    content: ReactNode;
+};
+export type WizardProps = Omit<HTMLAttributes<HTMLElement>, 'children'> & {
+    /** The steps, in order. */
+    steps: readonly WizardStep[];
+    /** Zero-based index of the current step; the caller owns this state. */
+    activeStep: number;
+    /** Called with the requested zero-based step index on Back or Continue; set `activeStep` to accept it. */
+    onStepChange: (step: number) => void;
+    /** Called when the last step is submitted. */
+    onComplete: () => void;
+    /** Step list above the content ('horizontal', the default) or beside it ('vertical'). */
+    orientation?: 'horizontal' | 'vertical';
+    /** Shows "Step N of M" above the buttons; defaults to true. */
+    showStepCount?: boolean;
+    /** Shows a spinner on the forward button and blocks navigation; defaults to false. */
+    loading?: boolean;
+    /** Accessible name for the whole wizard (not shown); defaults to "Wizard". */
+    label?: string;
+    /** Back button text; defaults to "Back". */
+    backLabel?: string;
+    /** Forward button text on every step but the last; defaults to "Continue". */
+    nextLabel?: string;
+    /** Forward button text on the last step; defaults to "Complete". */
+    completeLabel?: string;
+    /** Skips the browser's built-in field validation on submit; defaults to true. */
+    noValidate?: boolean;
+    /** Heading level of each step's title, h1 to h6. Defaults to 3. */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+};
+/** A multi-step flow with a step list, Back and Continue. Step content contains fields, not nested forms. The caller accepts or rejects navigation. */
+export declare const Wizard: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    /** The steps, in order. */
+    steps: readonly WizardStep[];
+    /** Zero-based index of the current step; the caller owns this state. */
+    activeStep: number;
+    /** Called with the requested zero-based step index on Back or Continue; set `activeStep` to accept it. */
+    onStepChange: (step: number) => void;
+    /** Called when the last step is submitted. */
+    onComplete: () => void;
+    /** Step list above the content ('horizontal', the default) or beside it ('vertical'). */
+    orientation?: "horizontal" | "vertical";
+    /** Shows "Step N of M" above the buttons; defaults to true. */
+    showStepCount?: boolean;
+    /** Shows a spinner on the forward button and blocks navigation; defaults to false. */
+    loading?: boolean;
+    /** Accessible name for the whole wizard (not shown); defaults to "Wizard". */
+    label?: string;
+    /** Back button text; defaults to "Back". */
+    backLabel?: string;
+    /** Forward button text on every step but the last; defaults to "Continue". */
+    nextLabel?: string;
+    /** Forward button text on the last step; defaults to "Complete". */
+    completeLabel?: string;
+    /** Skips the browser's built-in field validation on submit; defaults to true. */
+    noValidate?: boolean;
+    /** Heading level of each step's title, h1 to h6. Defaults to 3. */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+} & import("react").RefAttributes<HTMLElement>>;

package/dist/workflow/Wizard.js

@@ -0,0 +1,31 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useEffect, useRef } from 'react';
+import { Button } from '../button/Button.js';
+import { Icon } from '../Icon.js';
+import { cx } from '../internal/cx.js';
+import { useDiyaMessages } from '../DiyaProvider.js';
+import { wizardMessages } from './wizard-messages.js';
+/** A multi-step flow with a step list, Back and Continue. Step content contains fields, not nested forms. The caller accepts or rejects navigation. */
+export const Wizard = forwardRef(function Wizard({ steps, activeStep, onStepChange, onComplete, orientation = 'horizontal', showStepCount = true, loading = false, label, backLabel, nextLabel, completeLabel, noValidate = true, headingLevel = 3, className, ...props }, ref) {
+    const t = useDiyaMessages('wizard', wizardMessages);
+    const index = Math.max(0, Math.min(Math.max(0, steps.length - 1), Number.isFinite(activeStep) ? Math.floor(activeStep) : 0));
+    const heading = useRef(null);
+    const previousStep = useRef(index);
+    useEffect(() => {
+        if (previousStep.current !== index)
+            heading.current?.focus();
+        previousStep.current = index;
+    }, [index]);
+    if (!steps.length)
+        return null;
+    const step = steps[index];
+    const Heading = `h${headingLevel}`;
+    const last = index === steps.length - 1;
+    return _jsxs("section", { "aria-label": label ?? t.label, ...props, ref: ref, className: cx('diya-workflow-surface diya-wizard', className), "data-orientation": orientation, "aria-busy": loading || undefined, children: [_jsx("ol", { className: "diya-wizard-steps", "aria-label": t.progress, children: steps.map((item, position) => _jsxs("li", { "aria-current": index === position ? 'step' : undefined, "data-complete": position < index, children: [_jsx("span", { children: position < index ? _jsx(Icon, { name: "check", size: 14 }) : position + 1 }), _jsx("strong", { children: item.label })] }, item.id)) }), _jsx("div", { className: "diya-wizard-body", children: _jsxs("form", { noValidate: noValidate, onSubmit: event => { event.preventDefault(); if (!loading) {
+                        if (last)
+                            onComplete();
+                        else
+                            onStepChange(index + 1);
+                    } }, children: [_jsxs("header", { children: [_jsx(Heading, { ref: heading, tabIndex: -1, className: "diya-wizard-title", children: step.title ?? step.label }), step.description && _jsx("p", { children: step.description })] }), step.content, showStepCount && _jsx("small", { className: "diya-wizard-summary", children: t.step(index + 1, steps.length) }), _jsxs("footer", { children: [_jsx(Button, { variant: "quiet", disabled: index === 0 || loading, onClick: () => onStepChange(index - 1), children: backLabel ?? t.back }), _jsx(Button, { type: "submit", loading: loading, children: last ? completeLabel ?? t.complete : nextLabel ?? t.next })] })] }) })] });
+});

package/dist/workflow/drawer-messages.d.ts

@@ -0,0 +1,4 @@
+/** drawer: English defaults, overridable through DiyaProvider `messages`. */
+export declare const drawerMessages: {
+    close: string;
+};

package/dist/workflow/drawer-messages.js

@@ -0,0 +1,2 @@
+/** drawer: English defaults, overridable through DiyaProvider `messages`. */
+export const drawerMessages = { close: 'Close drawer' };

package/dist/workflow/file-upload-messages.d.ts

@@ -0,0 +1,11 @@
+/** fileUpload: English defaults, overridable through DiyaProvider `messages`. */
+export declare const fileUploadMessages: {
+    title: string;
+    description: string;
+    choose: string;
+    remove: (name: string) => string;
+    rejected: (count: number) => string;
+    selected: (count: number) => string;
+    kilobytes: (size: string) => string;
+    megabytes: (size: string) => string;
+};

package/dist/workflow/file-upload-messages.js

@@ -0,0 +1,2 @@
+/** fileUpload: English defaults, overridable through DiyaProvider `messages`. */
+export const fileUploadMessages = { title: 'Add your files', description: 'Drop files here or choose from your device.', choose: 'Choose files', remove: (name) => `Remove ${name}`, rejected: (count) => `${count} ${count === 1 ? 'file could' : 'files could'} not be added. Check the accepted file types and size limit.`, selected: (count) => `${count} ${count === 1 ? 'file' : 'files'} selected.`, kilobytes: (size) => `${size} KB`, megabytes: (size) => `${size} MB` };

package/dist/workflow/form-messages.d.ts

@@ -0,0 +1,5 @@
+/** form: English defaults, overridable through DiyaProvider `messages`. */
+export declare const formMessages: {
+    submit: string;
+    cancel: string;
+};

package/dist/workflow/form-messages.js

@@ -0,0 +1,2 @@
+/** form: English defaults, overridable through DiyaProvider `messages`. */
+export const formMessages = { submit: 'Submit', cancel: 'Cancel' };

package/dist/workflow/wizard-messages.d.ts

@@ -0,0 +1,9 @@
+/** wizard: English defaults, overridable through DiyaProvider `messages`. */
+export declare const wizardMessages: {
+    label: string;
+    progress: string;
+    back: string;
+    next: string;
+    complete: string;
+    step: (step: number, total: number) => string;
+};

package/dist/workflow/wizard-messages.js

@@ -0,0 +1,2 @@
+/** wizard: English defaults, overridable through DiyaProvider `messages`. */
+export const wizardMessages = { label: 'Wizard', progress: 'Progress', back: 'Back', next: 'Continue', complete: 'Complete', step: (step, total) => `Step ${step} of ${total}` };

package/package.json

@@ -1,11 +1,86 @@
 {
   "name": "@idyeah/diya",
-  "version": "0.0.0",
-  "description": "DIYA: React components and patterns in Light, Dark and Glass. Launches 7 November 2026.",
+  "version": "1.0.1",
   "license": "MIT",
-  "author": "IDYeah Studio LLC",
-  "homepage": "https://diya.keya.studio",
-  "keywords": ["react", "components", "design-system", "ui"],
-  "files": ["README.md", "LICENSE"],
-  "publishConfig": { "access": "public" }
+  "type": "module",
+  "description": "React components and patterns: Light, Dark and Glass. MIT.",
+  "keywords": [
+    "react",
+    "react-components",
+    "components",
+    "ui",
+    "ui-components",
+    "component-library",
+    "design-system",
+    "dark-mode",
+    "glassmorphism",
+    "nextjs",
+    "vite",
+    "typescript",
+    "accessibility"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./charts": {
+      "types": "./dist/data-viz/index.d.ts",
+      "import": "./dist/data-viz/index.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./api.json": "./dist/api.json",
+    "./api.schema.json": "./dist/api.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json && node scripts/build-styles.mjs && node scripts/build-api.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm build && vitest run --config tests/vitest.config.mjs"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1 || ^19.0.0",
+    "react-dom": "^18.3.1 || ^19.0.0",
+    "echarts": "^6.1.0"
+  },
+  "peerDependenciesMeta": {
+    "echarts": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "18.3.28",
+    "@types/react-dom": "18.3.7",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.9.3",
+    "echarts": "6.1.0",
+    "vitest": "4.1.0",
+    "happy-dom": "20.9.0",
+    "@testing-library/react": "16.3.2",
+    "@testing-library/user-event": "14.6.1",
+    "@vitejs/plugin-react": "6.0.1",
+    "vite": "8.0.1",
+    "ajv": "8.20.0",
+    "react-hook-form": "7.90.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/idyeah-studio/diya.git",
+    "directory": "packages/diya"
+  },
+  "homepage": "https://diya13.ai",
+  "bugs": "https://github.com/idyeah-studio/diya/issues",
+  "publishConfig": {
+    "access": "public"
+  }
 }