@neo-ui-kit/react 0.0.0-stage → 1.0.0

package/dist/core/base.d.ts

@@ -0,0 +1,65 @@
+import type { AriaRole, CSSProperties, ReactNode, Ref } from "react";
+export type Material = "shell" | "card" | "glass" | "ruby" | "tile" | "input" | "dialog" | "ghost" | "danger";
+export type Variant = "primary" | "secondary" | "ghost" | "danger";
+export type ControlSize = "xs" | "sm" | "md" | "lg";
+export type LegacySize = "small" | "medium" | "large";
+export type Size = ControlSize | LegacySize;
+export type Tone = "success" | "warning" | "error" | "processing" | "pending" | "offline" | "info";
+export type TokenStyle = CSSProperties & {
+    [key: `--${string}`]: string | number | undefined;
+};
+export interface CommonProps {
+    children?: ReactNode;
+    className?: string;
+    style?: TokenStyle;
+    id?: string;
+    material?: Material;
+    size?: Size;
+    tone?: Tone;
+    /** Accessibility and test hooks reach the root element of every component. */
+    role?: AriaRole;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    "aria-live"?: "off" | "polite" | "assertive";
+    [data: `data-${string}`]: string | number | boolean | undefined;
+}
+export interface VectorNode {
+    tag: string;
+    props?: Record<string, unknown>;
+    children?: Array<VectorNode | string>;
+}
+export declare function classes(...values: (string | undefined | false)[]): string;
+export declare function normalizeSize(size?: Size): ControlSize | undefined;
+/** Root attributes shared by every component: `ad ad-<kebab-name>` class and data-ad-* hooks for CSS. */
+export declare function mark(name: string, p: CommonProps, material?: Material, extra?: string): {
+    id: string | undefined;
+    className: string;
+    style: TokenStyle | undefined;
+    "data-ad-component": string;
+    "data-ad-material": Material | undefined;
+    "data-ad-size": ControlSize | undefined;
+    "data-ad-tone": Tone | undefined;
+};
+/** Plain structural element with the standard component marks. */
+export declare function part(name: string, tag: "header" | "div" | "footer"): {
+    (p: CommonProps): import("react").DetailedReactHTMLElement<{
+        id: string | undefined;
+        className: string;
+        style: TokenStyle | undefined;
+        "data-ad-component": string;
+        "data-ad-material": Material | undefined;
+        "data-ad-size": ControlSize | undefined;
+        "data-ad-tone": Tone | undefined;
+    }, HTMLElement>;
+    displayName: string;
+};
+export declare function useControllable<T>(value: T | undefined, initial: T, onChange?: (value: T) => void): readonly [T, (next: T | ((value: T) => T)) => void];
+export declare function assignRef<T>(ref: Ref<T> | undefined, value: T | null): void;
+export declare const clamp: (v: number, min?: number, max?: number) => number;
+export declare const cssRem: (value: number) => string;
+export declare const timeText: (value: number) => string;
+export declare function copyText(text: string): Promise<boolean>;
+export declare function downloadFile(name: string, content: string, type?: string): void;
+/** Spreads a ring of light from the pointer inside `host` (which should clip its overflow). */
+export declare function ripple(host: HTMLElement, clientX: number, clientY: number): void;

package/dist/core/environment.d.ts

@@ -0,0 +1,5 @@
+export declare const createResizeObserver: (callback: ResizeObserverCallback) => ResizeObserver;
+export declare const canObserveIntersection: () => boolean;
+export declare const reducedMotionQuery: () => MediaQueryList;
+/** jsdom has canvas elements but no 2D context unless the native canvas package is added. */
+export declare const canPaint: () => boolean;

package/dist/core/i18n.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from "react";
+/** Languages the library speaks out of the box; any other code works with your own messages. */
+export type Locale = "ru" | "en" | "uk" | (string & {});
+/** Translations of the library's own texts. The key is the Russian original, e.g. "Закрыть". */
+export type Messages = Record<string, string>;
+/**
+ * A text of the library in the current language: `tr("Закрыть")` is "Close" in English.
+ * `{name}` placeholders are filled from `vars`. Unknown texts come back as they are.
+ */
+export declare function tr(text: string, vars?: Record<string, string | number>): string;
+export declare function translate(locale: Locale, text: string, vars?: Record<string, string | number>, messages?: Messages): string;
+/** The language of the library's texts for everything rendered after this call. */
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+/** Your own translations (a new language, or other wording for a built-in one). */
+export declare function addMessages(locale: Locale, messages: Messages): void;
+/** Plural form by Slavic rules (one / few / many); English uses one / many. */
+export declare function plural(n: number, one: string, few: string, many: string, locale?: Locale): string;
+export interface LocaleProviderProps {
+    /** Built-in ru, en or uk, or a custom locale with its own messages. */
+    locale: Locale;
+    /** Overrides apply only to this provider's descendants. Keys are Russian source texts. */
+    messages?: Messages;
+    children?: ReactNode;
+}
+/**
+ * Sets the language of every library text inside it. Changing `locale` re-renders the tree
+ * under it in the new language; `messages` overrides translations only in this tree.
+ */
+export declare function LocaleProvider({ locale, messages, children }: LocaleProviderProps): import("react").JSX.Element;
+/** The language set by the nearest LocaleProvider. */
+export declare function useLocale(): Locale;
+/** A translator bound to the nearest provider, safe across independent React roots. */
+export declare function useTr(): (text: string, vars?: Record<string, string | number>) => string;

package/dist/core/messages.d.ts

@@ -0,0 +1 @@
+export declare const messages: Record<string, Record<string, string>>;

package/dist/core/motion/hooks.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+/** One scheduler in the engine; every observer and subscription is detached on unmount. */
+export declare function useDecoration(ref: React.RefObject<Element | null>, paint: (time: number) => void): void;
+export declare function useBorder(ref: React.RefObject<HTMLElement | null>, enabled?: boolean, shell?: boolean, round?: boolean): void;
+/**
+ * Runs a callback on the shared motion clock while `active`: positions, meters and other live
+ * read-outs update in step with every animation instead of asking for frames of their own.
+ */
+export declare function useTick(callback: (now: number) => void, active?: boolean): void;
+/** Pauses the animations of a block (and everything in it) while it is outside the viewport. */
+export declare function usePauseOffscreen(ref: React.RefObject<Element | null>): void;
+export declare function useTabShape(ref: React.RefObject<HTMLButtonElement | null>): void;
+/**
+ * Mouse-wheel notches glide to their target instead of jumping. Trackpads already glide and
+ * keep native scrolling; an inner scroller that can still move takes the wheel itself.
+ */
+export declare function useSmoothWheel(ref: React.RefObject<HTMLElement | null>): void;

package/dist/core/motion-engine.d.ts

@@ -0,0 +1,13 @@
+export function refreshMotion(): void;
+/** Diagnostic snapshot for lifecycle tests; not used to render the UI. */
+export function getMotionStats(): {
+    scopes: number;
+    running: number;
+    scheduled: boolean;
+    callbacks: any;
+};
+export const createMotion: any;
+export const attachBorder: any;
+export const attachTabShape: any;
+export const setMotionFrameRate: any;
+export const subscribeTick: any;

package/dist/core/noise.d.ts

@@ -0,0 +1,20 @@
+/** Deterministic randomness and value noise for procedural artwork (same picture on every render). */
+export declare const clamp01: (value: number, minimum?: number, maximum?: number) => number;
+/** Seeded generator (mulberry32): returns a function giving numbers in [0, 1). */
+export declare function seeded(initialSeed: number): () => number;
+/** Smooth 2D value noise in [0, 1]. */
+export declare function noise(x: number, y: number): number;
+/** Fractal noise: several octaves of value noise. */
+export declare function fbm(initialX: number, initialY: number, octaves?: number): number;
+/** A procedural picture: rows of pixels computed one by one, then optional vector strokes. */
+export interface Painting {
+    /** Fill rows `from`..`to` of the image; scale from `image.width` to stay resolution-free. */
+    pixels(image: ImageData, from: number, to: number): void;
+    /** Draw on top of the pixels (stars, glows, outlines). */
+    finish?(context: CanvasRenderingContext2D, width: number, height: number): void;
+}
+/**
+ * Paints a picture into an offscreen canvas in short idle-time slices, so even a large
+ * one stays responsive, and keeps it: every instance of the same size reuses the result.
+ */
+export declare function paintCanvas(key: string, width: number, height: number, painting: Painting): Promise<HTMLCanvasElement>;

package/dist/core/providers/context.d.ts

@@ -0,0 +1,4 @@
+export declare function useReducedMotion(): boolean;
+/** Read the current motion setting only when an interaction needs it. */
+export declare function motionEnabled(): boolean;
+export declare function useMotion(): boolean;

package/dist/core/responsive.d.ts

@@ -0,0 +1,13 @@
+import type { CSSProperties } from "react";
+export type Breakpoint = "base" | "sm" | "md" | "lg" | "xl";
+export type Responsive<T> = T | Partial<Record<Breakpoint, T>>;
+export type Spacing = number | string;
+/** Numbers are steps of the spacing scale; strings are raw CSS lengths. */
+export declare function spacing(value: Spacing): string;
+/**
+ * `--ad-<name>` plus `--ad-<name>-<bp>` for every breakpoint, each carrying the nearest
+ * smaller value forward (starting from `fallback`). Every layout sets all of its own
+ * variables, so nested layouts never inherit a parent's and CSS reads one variable per
+ * breakpoint without fallback chains.
+ */
+export declare function responsiveVars<T>(name: string, value: Responsive<T> | undefined, format?: (item: T) => string, fallback?: T): CSSProperties;

package/dist/core.d.ts

@@ -0,0 +1,8 @@
+export { ThemeProvider, themes, } from "./components/foundation/ThemeProvider/ThemeProvider";
+export type { ThemeName, ThemeProviderProps, } from "./components/foundation/ThemeProvider/ThemeProvider";
+export { useReducedMotion, useMotion } from "./core/providers/context";
+export { useBorder, usePauseOffscreen, useTick, useDecoration, useSmoothWheel, useTabShape, } from "./core/motion/hooks";
+export { getMotionStats, setMotionFrameRate, subscribeTick } from "./core/motion-engine.js";
+export { LocaleProvider, addMessages, getLocale, plural, setLocale, tr, translate, useLocale, useTr } from "./core/i18n";
+export type { Locale, LocaleProviderProps, Messages } from "./core/i18n";
+export { messages as builtInMessages } from "./core/messages";

package/dist/core.js

@@ -0,0 +1,56 @@
+import {
+  ThemeProvider,
+  themes
+} from "./chunks/chunk-JZ4GDTH5.js";
+import {
+  getMotionStats,
+  setMotionFrameRate,
+  subscribeTick,
+  useBorder,
+  useDecoration,
+  usePauseOffscreen,
+  useSmoothWheel,
+  useTabShape,
+  useTick
+} from "./chunks/chunk-YKCUOZ7V.js";
+import {
+  LocaleProvider,
+  addMessages,
+  getLocale,
+  messages,
+  plural,
+  setLocale,
+  tr,
+  translate,
+  useLocale,
+  useTr
+} from "./chunks/chunk-BJSFN52W.js";
+import {
+  useMotion,
+  useReducedMotion
+} from "./chunks/chunk-FCOU3ODR.js";
+export {
+  LocaleProvider,
+  ThemeProvider,
+  addMessages,
+  messages as builtInMessages,
+  getLocale,
+  getMotionStats,
+  plural,
+  setLocale,
+  setMotionFrameRate,
+  subscribeTick,
+  themes,
+  tr,
+  translate,
+  useBorder,
+  useDecoration,
+  useLocale,
+  useMotion,
+  usePauseOffscreen,
+  useReducedMotion,
+  useSmoothWheel,
+  useTabShape,
+  useTick,
+  useTr
+};

package/dist/editor.d.ts

@@ -0,0 +1,2 @@
+export { PianoRoll } from "./components/editor/PianoRoll/PianoRoll";
+export type { PianoRollProps, PianoRollNote, PianoRollWord, PianoRollGesture } from "./components/editor/PianoRoll/PianoRoll";

package/dist/editor.js

@@ -0,0 +1,8 @@
+import {
+  PianoRoll
+} from "./chunks/chunk-VK6GHRLV.js";
+import "./chunks/chunk-BJSFN52W.js";
+import "./chunks/chunk-FCOU3ODR.js";
+export {
+  PianoRoll
+};

package/dist/fonts/melodix/OFL-PlayfairDisplay.txt

@@ -0,0 +1,93 @@
+Copyright 2017 The Playfair Display Project Authors (https://github.com/clauseggers/Playfair-Display), with Reserved Font Name "Playfair Display"
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/melodix.css

@@ -0,0 +1,123 @@
+/* Melodix: the musical display typeface, in nine weights (100 Thin … 900 Black). Records, piano
+   keys, note heads, strings and waveforms are part of the letters themselves; the Latin S carries a
+   treble clef (a loop above, a hook with a note head below). Capitals of Cyrillic (Russian and
+   Ukrainian) and Latin, digits, ! ? : ; , … and ♩ ♪ ♫ ♬ 𝄞 ♥ #; lowercase letters are the same shapes
+   as small capitals. Traced from the large Melodix sheet, weights grown or slimmed from it.
+   "Melodix Text" is the cut for small sizes (body text, menus, labels under ~24 px): the engraving
+   finer than a screen pixel is filled in so the letters stay clear, records and notes stay.
+   Greek and the remaining punctuation come from Playfair Display (SIL Open Font License 1.1, see
+   melodix/OFL-PlayfairDisplay.txt). Each weight downloads only when some text uses it. */
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-100.woff2") format("woff2");
+  font-weight: 100;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-200.woff2") format("woff2");
+  font-weight: 200;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-300.woff2") format("woff2");
+  font-weight: 300;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-400.woff2") format("woff2");
+  font-weight: 400;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-500.woff2") format("woff2");
+  font-weight: 500;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-600.woff2") format("woff2");
+  font-weight: 600;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-700.woff2") format("woff2");
+  font-weight: 700;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-800.woff2") format("woff2");
+  font-weight: 800;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix";
+  src: url("./melodix/Melodix-900.woff2") format("woff2");
+  font-weight: 900;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-100.woff2") format("woff2");
+  font-weight: 100;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-200.woff2") format("woff2");
+  font-weight: 200;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-300.woff2") format("woff2");
+  font-weight: 300;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-400.woff2") format("woff2");
+  font-weight: 400;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-500.woff2") format("woff2");
+  font-weight: 500;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-600.woff2") format("woff2");
+  font-weight: 600;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-700.woff2") format("woff2");
+  font-weight: 700;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-800.woff2") format("woff2");
+  font-weight: 800;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Melodix Text";
+  src: url("./melodix/MelodixText-900.woff2") format("woff2");
+  font-weight: 900;
+  font-display: swap;
+}
+:root,
+.ad-theme {
+  --ad-font-family-melodix: "Melodix", Georgia, serif;
+  /* the same letters cut for small sizes: use it for running text, menus and labels */
+  --ad-font-family-melodix-text: "Melodix Text", "Melodix", Georgia, serif;
+}

package/dist/forms.d.ts

@@ -0,0 +1,4 @@
+export { Form, useForm, useFormContext } from "./components/forms/Form/Form";
+export type { FormApi, FormErrors, FormProps, UseFormOptions, } from "./components/forms/Form/Form";
+export { FormFields, defaultFieldRegistry, } from "./components/forms/FormFields/FormFields";
+export type { FormFieldsProps, FormFieldDefinition, FieldKind, FieldRegistry, } from "./components/forms/FormFields/FormFields";

package/dist/forms.js

@@ -0,0 +1,17 @@
+import {
+  Form,
+  FormFields,
+  defaultFieldRegistry,
+  useForm,
+  useFormContext
+} from "./chunks/chunk-UGDRXR7P.js";
+import "./chunks/chunk-YKCUOZ7V.js";
+import "./chunks/chunk-BJSFN52W.js";
+import "./chunks/chunk-FCOU3ODR.js";
+export {
+  Form,
+  FormFields,
+  defaultFieldRegistry,
+  useForm,
+  useFormContext
+};