@nice-code/state 0.7.0 → 0.9.0

package/build/types/devtools/core/StateDevtoolsCore.d.ts

@@ -1,56 +0,0 @@
-import type { Store } from "../../core/Store";
-import type { IDevtoolsStateChange, IStateDevtoolsSnapshot, TStateDevtoolsListener } from "./StateDevtools.types";
-export interface IStateDevtoolsCoreOptions {
-    /** Cap on retained changes across all stores (oldest dropped first). */
-    maxChanges?: number;
-}
-/**
- * Framework-agnostic collector for nice-state stores.
- *
- * Register any {@link Store} and the core hooks its patch + update streams,
- * pairing the two so each committed mutation becomes a single
- * {@link IDevtoolsStateChange} with patches and full before/after snapshots.
- * The browser panel ({@link NiceStateDevtools}) renders whatever this exposes.
- *
- * Registering a store attaches a patch listener, which makes Immer compute
- * patches for that store's updates — a negligible dev-time cost. Keep this out
- * of production bundles (the panel is dev-gated, but the core is not).
- */
-export declare class StateDevtoolsCore {
-    private readonly _stores;
-    private _changes;
-    private readonly _listeners;
-    private readonly _maxChanges;
-    private _paused;
-    private _cuidCounter;
-    private _sourceOverride;
-    constructor(options?: IStateDevtoolsCoreOptions);
-    /**
-     * Start observing a store under a human-readable label. Returns an
-     * unregister function. If the label collides with an existing store, a numeric
-     * suffix is appended to keep ids unique.
-     */
-    registerStore(label: string, store: Store<any>): () => void;
-    unregisterStore(id: string): void;
-    /**
-     * Replace a registered store's state wholesale — the primary "edit directly
-     * for testing" entry point. The resulting change is tagged `devtools-edit`.
-     */
-    applyEdit(storeId: string, newState: unknown): void;
-    /**
-     * Undo a change by applying its inverse patches. Cleanest for the most recent
-     * change of a store; older reverts may not apply if later changes touched the
-     * same paths. The resulting change is tagged `devtools-revert`.
-     */
-    revertChange(change: IDevtoolsStateChange): void;
-    setPaused(paused: boolean): void;
-    togglePaused(): void;
-    /** Drop the recorded timeline; registered stores and their state remain. */
-    clear(): void;
-    getSnapshot(): IStateDevtoolsSnapshot;
-    subscribe(listener: TStateDevtoolsListener): () => void;
-    private _recordChange;
-    private _uniqueId;
-    private _buildSnapshot;
-    private _notify;
-}

package/build/types/devtools/core/devtools_colors.d.ts

@@ -1,26 +0,0 @@
-export declare const DEVTOOL_COLOR_SEMANTIC_ERROR = "#FF5C5C";
-export declare const DEVTOOL_COLOR_SEMANTIC_SUCCESS = "#A3E635";
-export declare const DEVTOOL_COLOR_SEMANTIC_SYSTEM = "#38BDF8";
-export declare const DEVTOOL_COLOR_SEMANTIC_WARNING = "#FB923C";
-export declare const DEVTOOL_COLOR_SEMANTIC_METADATA = "#A1A1AA";
-export declare const DEVTOOL_COLOR_TEXT_EMPHASIS = "#f1f5f9";
-export declare const DEVTOOL_COLOR_TEXT_SECONDARY = "#cbd5e1";
-export declare const DEVTOOL_COLOR_TEXT_MUTED = "#64748b";
-export declare const DEVTOOL_COLOR_TEXT_FAINT = "#334155";
-export declare const DEVTOOL_LIST_BASE_BACKGROUND = "#0f172a";
-export declare const DEVTOOL_LIST_SELECTED_BACKGROUND = "#1d2942";
-export declare const DEVTOOL_DETAIL_BASE_BACKGROUND = "#0d1729";
-export declare const DEVTOOL_DETAIL_HEADER_BACKGROUND = "#131f35";
-export declare const DEVTOOL_SECTION_BACKGROUND = "#1e293b";
-export declare const DEVTOOL_SECTION_STRING_BACKGROUND = "#0d131f";
-export declare const DEVTOOL_PANEL_BORDER = "#1e293b";
-export declare const DEVTOOL_PANEL_DIVIDER_BORDER = "#1d3352";
-export declare const DEVTOOL_EDITOR_BACKGROUND = "#08101f";
-export declare const DEVTOOL_ERROR_BACKGROUND = "#1e0a0a";
-export declare const DEVTOOL_JSON_KEY = "#a5b4fc";
-export declare const DEVTOOL_JSON_STRING = "#fbbf24";
-export declare const DEVTOOL_JSON_NUMBER = "#34d399";
-export declare const DEVTOOL_JSON_KEYWORD = "#a78bfa";
-export declare const DEVTOOL_JSON_PUNCTUATION = "#475569";
-export declare const MONO_FONT = "ui-monospace, 'Cascadia Code', 'Source Code Pro', monospace";
-export declare const SANS_FONT = "ui-sans-serif, system-ui, sans-serif";

package/build/types/index.d.ts

@@ -1 +0,0 @@
-export * from "./core";

package/build/types/react/InjectStoreState.d.ts

@@ -1,18 +0,0 @@
-import type { ReactElement } from "react";
-import type { Store } from "../core/Store";
-import { type TEqualityFn } from "./useStoreState";
-export interface IPropsInjectStoreState<S extends object, SS> {
-    store: Store<S>;
-    on?: (state: S) => SS;
-    /**
-     * Optional equality function for the selected slice. Defaults to a strict
-     * reference check; pass `deepEqual` from `fast-equals` for inline objects.
-     */
-    equalityFn?: TEqualityFn<SS>;
-    children: (output: SS) => ReactElement;
-}
-/**
- * Render-prop binding: subscribes to `store` (optionally narrowed by `on`) and
- * renders `children` with the selected slice.
- */
-export declare function InjectStoreState<S extends object, SS = S>({ store, on, equalityFn, children, }: IPropsInjectStoreState<S, SS>): ReactElement;

package/build/types/react/index.d.ts

@@ -1,3 +0,0 @@
-export { InjectStoreState, type IPropsInjectStoreState } from "./InjectStoreState";
-export { useLocalStore } from "./useLocalStore";
-export { type TEqualityFn, useStoreState } from "./useStoreState";

package/build/types/react/useLocalStore.d.ts

@@ -1,8 +0,0 @@
-import { Store } from "../core/Store";
-/**
- * Create a component-local {@link Store} that persists across renders. Passing a
- * `deps` array re-creates the store (with a fresh initial state) whenever the
- * dependencies change by shallow comparison.
- */
-declare function useLocalStore<S extends object>(initialState: (() => S) | S, deps?: ReadonlyArray<unknown>): Store<S>;
-export { useLocalStore };

package/build/types/react/useStoreState.d.ts

@@ -1,23 +0,0 @@
-import type { Store } from "../core/Store";
-/**
- * Compares the previously selected value against the next one. Returning `true`
- * tells the hook the value is unchanged, so React is handed the *same*
- * reference and no re-render is scheduled.
- */
-export type TEqualityFn<SS> = (a: SS, b: SS) => boolean;
-/**
- * Subscribe a React component to a store, optionally narrowing to a derived
- * slice.
- *
- * Built on `useSyncExternalStore`, so it is tear-free under React 18+
- * concurrent rendering with no manual `useState`/`useEffect` subscription loop.
- *
- * A `useRef` cache holds the last selected value. On every store emission the
- * selector is re-evaluated and the result is run through a strict-reference
- * fast-path first; only if the reference differs is `equalityFn` consulted. A
- * new reference is handed back to React exclusively when a genuine change is
- * detected, so equal-but-new selector results never trigger a render.
- */
-declare function useStoreState<S extends object>(store: Store<S>): S;
-declare function useStoreState<S extends object, SS>(store: Store<S>, getSubState: (state: S) => SS, equalityFn?: TEqualityFn<SS>): SS;
-export { useStoreState };