tweakit 0.5.1 → 0.6.0

package/dist/types/tweaks/easing.d.ts

@@ -1,18 +1,15 @@
-import type { GradientEasing, GradientValue } from "./types.js";
+import type { GradientValue } from "./types.js";
 /** cubic-bezier control points [x1, y1, x2, y2]. */
-type Bez = [number, number, number, number];
-/** Bezier control points, or null for linear and anything unrecognised (bad input degrades to a
+export type Bez = [number, number, number, number];
+export declare const KEYWORDS: Record<string, Bez>;
+/** Bezier control points, or null for linear and anything unrecognized (bad input degrades to a
  *  straight blend). x1/x2 clamp into [0,1] as CSS requires; y may overshoot. */
 export declare function parseEasing(e: unknown): Bez | null;
-/** The name an easing is stored under: trimmed and lowercased when parseEasing knows it, else "linear". */
-export declare const easingName: (e: unknown) => GradientEasing;
 /** The curve at 16 even t: [x, y] pairs, y clamped to [0,1] since it becomes a color-mix percentage. */
 export declare function easingSamples(b: Bez): Array<[number, number]>;
-/** The blend progress at a position, linear between samples exactly as the browser draws the
- *  stops, so a stop inserted at x takes the colour the ramp really shows. Null is the identity. */
-export declare function easingAt(b: Bez | null, x: number): number;
-/** A gradient value's `<color-stop-list>` with the easing expanded; for a conic / radial gradient. */
+/** A gradient value's `<color-stop-list>` with the easing expanded; for a conic / radial gradient.
+ *  One stop comes back doubled and none as `transparent, transparent`, so the list stays valid. */
 export declare function gradientStops(value: GradientValue): string;
-/** The `linear-gradient(…)` for a gradient value; `direction` is degrees or any CSS direction. */
+/** The `linear-gradient(…)` for a gradient value; `direction` is degrees or any CSS direction.
+ *  One stop draws a solid fill and no stops is `none`, both still valid for background-image. */
 export declare function gradientCss(value: GradientValue, direction?: number | string): string;
-export {};

package/dist/types/tweaks/panel.d.ts

@@ -1,4 +1,4 @@
-import type { Schema, TweaksOptions, Panel, Control } from "./types.js";
+import type { HeldSchema, TweaksOptions, Panel, ParamsOf, KnownTypes, Control } from "./types.js";
 import type { Meta } from "./schema.js";
 /** A params object or one of its folder/tabs sub-objects — the holder a control writes into. */
 type Target = Record<string, unknown>;
@@ -14,9 +14,12 @@ export interface Entry {
     persist: boolean;
     m: Meta;
     el: HTMLElement;
+    note?: Control["note"];
+    range?: Control["range"];
 }
-/** A values snapshot — params minus `_last`, as JSON round-trips it. */
+/** A values snapshot — params as JSON round-trips it. */
 export type Snapshot = Record<string, any>;
-/** Build a panel from `schema`; the shell and API exist synchronously, lazy controls fill in on `ready`. */
-export declare function tweaks(name: string, schema: Schema, opts?: TweaksOptions): Panel;
+/** Build a panel from `schema`; the shell and API exist synchronously, lazy controls fill in on `ready`.
+ *  A schema written inline (or `as const`) types `params` from its shape. */
+export declare function tweaks<const S extends HeldSchema>(name: string, schema: S & KnownTypes<S>, opts?: TweaksOptions): Panel<ParamsOf<S>>;
 export {};

package/dist/types/tweaks/schema.d.ts

@@ -1,7 +1,8 @@
-import type { SchemaObject, Option, Get, Control } from "./types.js";
+import type { SchemaObject, Option, Get } from "./types.js";
 /** A point control's component spec, as the public verbose form declares it. */
 type PointComponent = Extract<SchemaObject, {
     type: "point";
+    components: ReadonlyArray<unknown>;
 }>["components"][number];
 /** One page of a tabs control: its slug key, title and the metas built inside it. */
 interface TabPage {
@@ -56,6 +57,8 @@ interface Meta {
     interval?: number;
     decimals?: number;
     maxSize?: number;
+    fit?: number | false;
+    quality?: number;
     upload?: boolean;
     clear?: boolean;
     action?: () => void;
@@ -69,12 +72,7 @@ interface Meta {
 /** A verbose handler's result: the control's own fields, or falsy for a malformed shape. */
 type MetaFields = Partial<Meta> | false;
 declare function metaFor(key: string, value: any, depth?: number): Meta | null;
-declare const hasOwn: <T extends object>(o: T, k: PropertyKey) => k is keyof T;
-declare const isReservedKey: (k: string) => k is "__proto__" | "constructor" | "prototype";
-declare const valueChanged: (a: unknown, b: unknown) => boolean;
-declare const restoreDefault: (ctrl: Pick<Control, "set">, raw: unknown, def: unknown) => void;
-declare const SPRING_KEYS: string[];
-declare const TYPED_META: Partial<Record<SchemaObject["type"], (v: any, depth: number) => MetaFields>>;
+declare const TYPED_META: Partial<Record<SchemaObject["type"], (v: any, depth: number, key: string) => MetaFields>>;
 declare const VALUELESS: Set<string>;
-export { metaFor, valueChanged, restoreDefault, hasOwn, isReservedKey, VALUELESS, TYPED_META, SPRING_KEYS };
+export { metaFor, VALUELESS, TYPED_META };
 export type { Meta, TabPage, PointComponent };

package/dist/types/tweaks/standalone.d.ts

@@ -1,5 +1,5 @@
-import type { SchemaValue, MountOptions, MountedControl, ColorPickerOptions, ColorPicker } from "./types.js";
+import type { HeldValue, KnownType, MountOptions, MountedControl, ColorPickerOptions, ColorPicker } from "./types.js";
 /** One control from a schema value, into `host`; a folder or tabs set is tweaks()'s to build. */
-export declare function mountControl(host: Element, value: SchemaValue, opts?: MountOptions): MountedControl;
-/** The colour editor surface alone, for a host page that brings its own swatch. */
+export declare function mountControl<const V extends HeldValue>(host: Element, value: V & KnownType<V>, opts?: MountOptions): MountedControl;
+/** The color editor surface alone, for a host page that brings its own swatch. */
 export declare function createColorPicker(opts?: ColorPickerOptions): ColorPicker;