redux-sparse-kit 0.0.0-stage → 0.1.1

package/dist/react.d.ts

@@ -0,0 +1,83 @@
+import { c as SparseStoreExt, u as AnySegment } from "./sparseEnhancer-CIcdhh-P.js";
+import { Store } from "redux";
+import { Context, ReactNode } from "react";
+//#region src/react/reactReduxContext.d.ts
+/** The parts of a react-redux context value this package relies on. */
+interface ReactReduxContextValueLike {
+  store: Store & Partial<SparseStoreExt>;
+  [key: string]: unknown;
+}
+type ReactReduxContextLike = Context<ReactReduxContextValueLike | null>;
+/**
+ * The context react-redux's `<Provider>` fills. React-redux keeps it in a
+ * registry on `globalThis`, keyed by the React instance, so that every copy
+ * of react-redux shares it; reading the same registry finds it without a
+ * dependency on any particular build of react-redux.
+ */
+declare function getReactReduxContext(): ReactReduxContextLike;
+//#endregion
+//#region src/react/scopeChecks.d.ts
+/** A read of a segment's slice made outside every scope that holds it. */
+interface ScopeViolation {
+  /** The key of the segment slice that was read. */
+  key: string;
+  /**
+   * The selector that read it, when react-redux reports reads through
+   * `onStateAccess`; otherwise `undefined`.
+   */
+  selector: Function | undefined;
+  /** The segment keys available where it was read. */
+  scope: readonly string[];
+}
+type ScopeViolationHandler = (violation: ScopeViolation) => void;
+//#endregion
+//#region src/react/createSparseReact.d.ts
+interface SparseReactOptions {
+  /**
+   * The context the react-redux `<Provider>` was given. Defaults to
+   * react-redux's own context.
+   */
+  context?: ReactReduxContextLike;
+  /**
+   * Checks that components read segment slices only inside a scope that holds
+   * them. Defaults to `true` outside production builds.
+   */
+  checks?: boolean;
+  /**
+   * Called for each read of a segment slice outside the scopes that hold it.
+   * Defaults to logging each key once per selector with `console.error`.
+   */
+  onViolation?: ScopeViolationHandler;
+}
+interface SparseScopeProps {
+  /** Segments held for as long as the scope is mounted. */
+  segments: readonly AnySegment[];
+  /** Rendered until the segments are present in the store. */
+  fallback?: ReactNode;
+  children?: ReactNode;
+}
+interface SparseReact {
+  /**
+   * Holds `segments` for as long as the calling component is mounted and
+   * returns whether they are all present in the store yet.
+   */
+  useSparseSegments(segments: readonly AnySegment[]): boolean;
+  /**
+   * Holds `segments` for as long as it is mounted, and renders its children
+   * only once they are present in the store. With checks on, reads of segment
+   * slices below it that no enclosing scope holds are reported; a scope with
+   * no segments checks the reads below it that no scope holds at all.
+   */
+  SparseScope(props: SparseScopeProps): ReactNode;
+}
+/** Creates the React bindings for stores made with `sparseEnhancer`. */
+declare function createSparseReact(options?: SparseReactOptions): SparseReact;
+//#endregion
+//#region src/react/index.d.ts
+/** {@inheritDoc SparseReact.SparseScope} */
+declare const SparseScope: SparseReact["SparseScope"];
+/** {@inheritDoc SparseReact.useSparseSegments} */
+declare const useSparseSegments: SparseReact["useSparseSegments"];
+//#endregion
+export { type ReactReduxContextLike, type ReactReduxContextValueLike, type ScopeViolation, type ScopeViolationHandler, type SparseReact, type SparseReactOptions, SparseScope, type SparseScopeProps, createSparseReact, getReactReduxContext, useSparseSegments };
+//# sourceMappingURL=react.d.ts.map

package/dist/react.js

@@ -0,0 +1,189 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_segment = require("./segment-Dqd6-ABS.js");
+let react = require("react");
+//#region src/react/reactReduxContext.ts
+const contextKey = Symbol.for("react-redux-context");
+/**
+* The context react-redux's `<Provider>` fills. React-redux keeps it in a
+* registry on `globalThis`, keyed by the React instance, so that every copy
+* of react-redux shares it; reading the same registry finds it without a
+* dependency on any particular build of react-redux.
+*/
+function getReactReduxContext() {
+	var _registry$contextKey;
+	const registry = globalThis;
+	const contexts = (_registry$contextKey = registry[contextKey]) !== null && _registry$contextKey !== void 0 ? _registry$contextKey : registry[contextKey] = /* @__PURE__ */ new Map();
+	let context = contexts.get(react.createContext);
+	if (!context) {
+		context = (0, react.createContext)(null);
+		context.displayName = "ReactRedux";
+		contexts.set(react.createContext, context);
+	}
+	return context;
+}
+//#endregion
+//#region src/react/scopeChecks.ts
+/** The segment keys the enclosing scopes hold, with their dependencies. */
+const ScopeKeysContext = (0, react.createContext)(/* @__PURE__ */ new Set());
+const baseListenerKey = Symbol("redux-sparse-kit.baseListener");
+const baseStoreKey = Symbol("redux-sparse-kit.baseStore");
+/** Whether this selector and key were seen before; records them if not. */
+const seenBefore = (reported, selector, key) => {
+	let keys = reported.get(selector);
+	if (!keys) {
+		keys = /* @__PURE__ */ new Set();
+		reported.set(selector, keys);
+	}
+	if (keys.has(key)) return true;
+	keys.add(key);
+	return false;
+};
+const reportedByDefault = /* @__PURE__ */ new Map();
+/** Logs each key once per selector, across all scopes. */
+const reportViolationOnce = ({ key, selector, scope }) => {
+	if (seenBefore(reportedByDefault, selector, key)) return;
+	const reader = selector ? `Selector "${selector.name || "anonymous"}"` : "A selector";
+	const available = scope.length > 0 ? scope.map((name) => `"${name}"`).join(", ") : "none";
+	console.error(`redux-sparse-kit: ${reader} read state.${key} outside every SparseScope holding "${key}" (segments available here: ${available}).`);
+};
+const createScopedStore = (parent, check) => {
+	var _parent$baseStoreKey;
+	const store = (_parent$baseStoreKey = parent[baseStoreKey]) !== null && _parent$baseStoreKey !== void 0 ? _parent$baseStoreKey : parent;
+	const proxies = /* @__PURE__ */ new WeakMap();
+	return {
+		...store,
+		[baseStoreKey]: store,
+		getState() {
+			const state = store.getState();
+			let proxy = proxies.get(state);
+			if (!proxy) {
+				proxy = new Proxy(state, { get(target, property, receiver) {
+					if (typeof property === "string") check(property);
+					return Reflect.get(target, property, receiver);
+				} });
+				proxies.set(state, proxy);
+			}
+			return proxy;
+		}
+	};
+};
+/**
+* The react-redux context value a scope passes down: it checks every state
+* read below it against the segment keys available there.
+*/
+function createCheckedContextValue(parent, available, report) {
+	const reported = /* @__PURE__ */ new Map();
+	const check = (key, selector) => {
+		if (require_segment.isSegmentKey(key) && !available.has(key) && !seenBefore(reported, selector, key)) report({
+			key,
+			selector,
+			scope: [...available]
+		});
+	};
+	if (parent.stateAccessTracking === true) {
+		const base = baseListenerKey in parent ? parent[baseListenerKey] : parent.onStateAccess;
+		const onStateAccess = (key, selector) => {
+			check(key, selector);
+			base === null || base === void 0 || base(key, selector);
+		};
+		return {
+			...parent,
+			onStateAccess,
+			[baseListenerKey]: base
+		};
+	}
+	return {
+		...parent,
+		store: createScopedStore(parent.store, (key) => check(key, void 0))
+	};
+}
+//#endregion
+//#region src/react/createSparseReact.ts
+const useIsomorphicLayoutEffect = typeof window === "undefined" ? react.useEffect : react.useLayoutEffect;
+const segmentIds = /* @__PURE__ */ new WeakMap();
+let nextSegmentId = 0;
+/** Identifies a list of segments by the identity of its members. */
+const signatureOf = (segments) => segments.map((segment) => {
+	let id = segmentIds.get(segment);
+	if (id === void 0) {
+		id = nextSegmentId++;
+		segmentIds.set(segment, id);
+	}
+	return id;
+}).join(",");
+/**
+* The same array for as long as it holds the same segments, so that a new
+* array literal on every render does not acquire them again.
+*/
+const useStableSegments = (segments) => {
+	const signature = signatureOf(segments);
+	return (0, react.useMemo)(() => segments, [signature]);
+};
+const collectKeys = (segments, keys) => {
+	for (const segment of segments) {
+		keys.add(segment.key);
+		collectKeys(segment.deps, keys);
+	}
+};
+/** Creates the React bindings for stores made with `sparseEnhancer`. */
+function createSparseReact(options = {}) {
+	const { checks = process.env.NODE_ENV !== "production", onViolation = reportViolationOnce } = options;
+	const getContext = () => {
+		var _options$context;
+		return (_options$context = options.context) !== null && _options$context !== void 0 ? _options$context : getReactReduxContext();
+	};
+	const useSparseController = () => {
+		const value = (0, react.useContext)(getContext());
+		if (!value) throw new Error("redux-sparse-kit needs a react-redux <Provider> above this component");
+		if (!value.store.sparse) throw new Error("redux-sparse-kit needs a store created with sparseEnhancer");
+		return value.store.sparse;
+	};
+	const useSparseSegments = (segments) => {
+		const sparse = useSparseController();
+		const [, rerender] = (0, react.useReducer)((count) => count + 1, 0);
+		const ready = segments.every((segment) => sparse.has(segment));
+		const stable = useStableSegments(segments);
+		useIsomorphicLayoutEffect(() => {
+			const release = sparse.acquire(...stable);
+			if (!ready) rerender();
+			return release;
+		}, [sparse, stable]);
+		return ready;
+	};
+	function SparseScope({ segments, fallback = null, children }) {
+		return useSparseSegments(segments) ? children : fallback;
+	}
+	function CheckedSparseScope({ segments, fallback = null, children }) {
+		const ready = useSparseSegments(segments);
+		const context = getContext();
+		const parent = (0, react.useContext)(context);
+		const parentKeys = (0, react.useContext)(ScopeKeysContext);
+		const stable = useStableSegments(segments);
+		const available = (0, react.useMemo)(() => {
+			const keys = new Set(parentKeys);
+			collectKeys(stable, keys);
+			return keys;
+		}, [parentKeys, stable]);
+		const value = (0, react.useMemo)(() => createCheckedContextValue(parent, available, onViolation), [parent, available]);
+		if (!ready) return fallback;
+		return (0, react.createElement)(ScopeKeysContext.Provider, { value: available }, (0, react.createElement)(context.Provider, { value }, children));
+	}
+	return {
+		useSparseSegments,
+		SparseScope: checks ? CheckedSparseScope : SparseScope
+	};
+}
+//#endregion
+//#region src/react/index.ts
+const defaults = createSparseReact();
+/** {@inheritDoc SparseReact.SparseScope} */
+const SparseScope = defaults.SparseScope;
+/** {@inheritDoc SparseReact.useSparseSegments} */
+const useSparseSegments = defaults.useSparseSegments;
+//#endregion
+exports.SparseScope = SparseScope;
+exports.createSparseReact = createSparseReact;
+exports.getReactReduxContext = getReactReduxContext;
+exports.useSparseSegments = useSparseSegments;
+
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":["createContext","createContext","isSegmentKey","useEffect","useLayoutEffect","useMemo","useContext","useReducer","createElement"],"sources":["../src/react/reactReduxContext.ts","../src/react/scopeChecks.ts","../src/react/createSparseReact.ts","../src/react/index.ts"],"sourcesContent":["import type { Context } from 'react';\nimport { createContext } from 'react';\nimport type { Store } from 'redux';\nimport type { SparseStoreExt } from '../sparseEnhancer';\n\n/** The parts of a react-redux context value this package relies on. */\nexport interface ReactReduxContextValueLike {\n  store: Store & Partial<SparseStoreExt>;\n  [key: string]: unknown;\n}\n\nexport type ReactReduxContextLike = Context<ReactReduxContextValueLike | null>;\n\nconst contextKey = Symbol.for('react-redux-context');\n\ntype ContextRegistry = Map<typeof createContext, ReactReduxContextLike>;\n\n/**\n * The context react-redux's `<Provider>` fills. React-redux keeps it in a\n * registry on `globalThis`, keyed by the React instance, so that every copy\n * of react-redux shares it; reading the same registry finds it without a\n * dependency on any particular build of react-redux.\n */\nexport function getReactReduxContext(): ReactReduxContextLike {\n  const registry = globalThis as { [contextKey]?: ContextRegistry };\n  const contexts = (registry[contextKey] ??= new Map());\n  let context = contexts.get(createContext);\n\n  if (!context) {\n    context = createContext<ReactReduxContextValueLike | null>(null);\n    context.displayName = 'ReactRedux';\n    contexts.set(createContext, context);\n  }\n\n  return context;\n}\n","import type { Context } from 'react';\nimport { createContext } from 'react';\nimport type { Store } from 'redux';\nimport { isSegmentKey } from '../segment';\nimport type { ReactReduxContextValueLike } from './reactReduxContext';\n\n/** A read of a segment's slice made outside every scope that holds it. */\nexport interface ScopeViolation {\n  /** The key of the segment slice that was read. */\n  key: string;\n  /**\n   * The selector that read it, when react-redux reports reads through\n   * `onStateAccess`; otherwise `undefined`.\n   */\n  selector: Function | undefined;\n  /** The segment keys available where it was read. */\n  scope: readonly string[];\n}\n\nexport type ScopeViolationHandler = (violation: ScopeViolation) => void;\n\ntype StateAccessListener = (key: string, selector: Function) => void;\n\n/** The segment keys the enclosing scopes hold, with their dependencies. */\nexport const ScopeKeysContext: Context<ReadonlySet<string>> = createContext<ReadonlySet<string>>(\n  new Set(),\n);\n\n// The listener a scope found in place, so that nested scopes call it instead\n// of the listener of the scope around them.\nconst baseListenerKey: unique symbol = Symbol('redux-sparse-kit.baseListener');\n\n// The store a scoped store wraps, so that nested scopes wrap the original\n// store rather than the scoped store of the scope around them.\nconst baseStoreKey: unique symbol = Symbol('redux-sparse-kit.baseStore');\n\ninterface CheckedContextValue extends ReactReduxContextValueLike {\n  [baseListenerKey]?: StateAccessListener | undefined;\n}\n\ntype ScopedStore = Store & { [baseStoreKey]?: Store };\n\ntype Reported = Map<Function | undefined, Set<string>>;\n\n/** Whether this selector and key were seen before; records them if not. */\nconst seenBefore = (reported: Reported, selector: Function | undefined, key: string) => {\n  let keys = reported.get(selector);\n  if (!keys) {\n    keys = new Set();\n    reported.set(selector, keys);\n  }\n\n  if (keys.has(key)) {\n    return true;\n  }\n  keys.add(key);\n  return false;\n};\n\nconst reportedByDefault: Reported = new Map();\n\n/** Logs each key once per selector, across all scopes. */\nexport const reportViolationOnce: ScopeViolationHandler = ({ key, selector, scope }) => {\n  if (seenBefore(reportedByDefault, selector, key)) {\n    return;\n  }\n\n  const reader = selector ? `Selector \"${selector.name || 'anonymous'}\"` : 'A selector';\n  const available = scope.length > 0 ? scope.map((name) => `\"${name}\"`).join(', ') : 'none';\n\n  console.error(\n    `redux-sparse-kit: ${reader} read state.${key} outside every SparseScope holding \"${key}\" ` +\n      `(segments available here: ${available}).`,\n  );\n};\n\nconst createScopedStore = (parent: ScopedStore, check: (key: string) => void): ScopedStore => {\n  const store = parent[baseStoreKey] ?? parent;\n  const proxies = new WeakMap<object, object>();\n\n  return {\n    ...store,\n    [baseStoreKey]: store,\n    getState() {\n      // Always an object: the root state of a store made with sparseEnhancer.\n      const state = store.getState() as object;\n\n      let proxy = proxies.get(state);\n      if (!proxy) {\n        proxy = new Proxy(state, {\n          get(target, property, receiver) {\n            if (typeof property === 'string') {\n              check(property);\n            }\n            return Reflect.get(target, property, receiver);\n          },\n        });\n        proxies.set(state, proxy);\n      }\n      return proxy;\n    },\n  };\n};\n\n/**\n * The react-redux context value a scope passes down: it checks every state\n * read below it against the segment keys available there.\n */\nexport function createCheckedContextValue(\n  parent: CheckedContextValue,\n  available: ReadonlySet<string>,\n  report: ScopeViolationHandler,\n): CheckedContextValue {\n  const reported: Reported = new Map();\n\n  // Each scope reports a selector reading a key once, however often it runs.\n  const check = (key: string, selector: Function | undefined) => {\n    if (isSegmentKey(key) && !available.has(key) && !seenBefore(reported, selector, key)) {\n      report({ key, selector, scope: [...available] });\n    }\n  };\n\n  if (parent.stateAccessTracking === true) {\n    const base =\n      baseListenerKey in parent\n        ? parent[baseListenerKey]\n        : (parent.onStateAccess as StateAccessListener | undefined);\n\n    const onStateAccess: StateAccessListener = (key, selector) => {\n      check(key, selector);\n      base?.(key, selector);\n    };\n\n    return { ...parent, onStateAccess, [baseListenerKey]: base };\n  }\n\n  return {\n    ...parent,\n    store: createScopedStore(parent.store, (key) => check(key, undefined)),\n  };\n}\n","import type { ReactNode } from 'react';\nimport { createElement, useContext, useEffect, useLayoutEffect, useMemo, useReducer } from 'react';\nimport type { AnySegment } from '../segment';\nimport type { SparseController } from '../sparseEnhancer';\nimport type { ReactReduxContextLike } from './reactReduxContext';\nimport { getReactReduxContext } from './reactReduxContext';\nimport type { ScopeViolationHandler } from './scopeChecks';\nimport { createCheckedContextValue, reportViolationOnce, ScopeKeysContext } from './scopeChecks';\n\n// Layout effects do not run on the server, and React warns about them there.\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\nconst segmentIds = new WeakMap<AnySegment, number>();\nlet nextSegmentId = 0;\n\n/** Identifies a list of segments by the identity of its members. */\nconst signatureOf = (segments: readonly AnySegment[]) =>\n  segments\n    .map((segment) => {\n      let id = segmentIds.get(segment);\n      if (id === undefined) {\n        id = nextSegmentId++;\n        segmentIds.set(segment, id);\n      }\n      return id;\n    })\n    .join(',');\n\n/**\n * The same array for as long as it holds the same segments, so that a new\n * array literal on every render does not acquire them again.\n */\nconst useStableSegments = (segments: readonly AnySegment[]) => {\n  const signature = signatureOf(segments);\n  // oxlint-disable-next-line react-hooks/exhaustive-deps -- tracked by their signature\n  return useMemo(() => segments, [signature]);\n};\n\nconst collectKeys = (segments: readonly AnySegment[], keys: Set<string>) => {\n  for (const segment of segments) {\n    keys.add(segment.key);\n    collectKeys(segment.deps, keys);\n  }\n};\n\nexport interface SparseReactOptions {\n  /**\n   * The context the react-redux `<Provider>` was given. Defaults to\n   * react-redux's own context.\n   */\n  context?: ReactReduxContextLike;\n  /**\n   * Checks that components read segment slices only inside a scope that holds\n   * them. Defaults to `true` outside production builds.\n   */\n  checks?: boolean;\n  /**\n   * Called for each read of a segment slice outside the scopes that hold it.\n   * Defaults to logging each key once per selector with `console.error`.\n   */\n  onViolation?: ScopeViolationHandler;\n}\n\nexport interface SparseScopeProps {\n  /** Segments held for as long as the scope is mounted. */\n  segments: readonly AnySegment[];\n  /** Rendered until the segments are present in the store. */\n  fallback?: ReactNode;\n  children?: ReactNode;\n}\n\nexport interface SparseReact {\n  /**\n   * Holds `segments` for as long as the calling component is mounted and\n   * returns whether they are all present in the store yet.\n   */\n  useSparseSegments(segments: readonly AnySegment[]): boolean;\n  /**\n   * Holds `segments` for as long as it is mounted, and renders its children\n   * only once they are present in the store. With checks on, reads of segment\n   * slices below it that no enclosing scope holds are reported; a scope with\n   * no segments checks the reads below it that no scope holds at all.\n   */\n  SparseScope(props: SparseScopeProps): ReactNode;\n}\n\n/** Creates the React bindings for stores made with `sparseEnhancer`. */\nexport function createSparseReact(options: SparseReactOptions = {}): SparseReact {\n  const { checks = process.env.NODE_ENV !== 'production', onViolation = reportViolationOnce } =\n    options;\n\n  const getContext = () => options.context ?? getReactReduxContext();\n\n  const useSparseController = (): SparseController => {\n    const value = useContext(getContext());\n\n    if (!value) {\n      throw new Error('redux-sparse-kit needs a react-redux <Provider> above this component');\n    }\n\n    if (!value.store.sparse) {\n      throw new Error('redux-sparse-kit needs a store created with sparseEnhancer');\n    }\n\n    return value.store.sparse;\n  };\n\n  const useSparseSegments = (segments: readonly AnySegment[]): boolean => {\n    const sparse = useSparseController();\n    const [, rerender] = useReducer((count: number) => count + 1, 0);\n    const ready = segments.every((segment) => sparse.has(segment));\n    const stable = useStableSegments(segments);\n\n    useIsomorphicLayoutEffect(() => {\n      const release = sparse.acquire(...stable);\n      if (!ready) {\n        // Rendered before they were injected: render again, before paint.\n        rerender();\n      }\n      return release;\n    }, [sparse, stable]);\n\n    return ready;\n  };\n\n  function SparseScope({ segments, fallback = null, children }: SparseScopeProps): ReactNode {\n    return useSparseSegments(segments) ? children : fallback;\n  }\n\n  function CheckedSparseScope({\n    segments,\n    fallback = null,\n    children,\n  }: SparseScopeProps): ReactNode {\n    const ready = useSparseSegments(segments);\n    const context = getContext();\n    const parent = useContext(context)!;\n    const parentKeys = useContext(ScopeKeysContext);\n    const stable = useStableSegments(segments);\n\n    const available = useMemo(() => {\n      const keys = new Set(parentKeys);\n      collectKeys(stable, keys);\n      return keys;\n    }, [parentKeys, stable]);\n\n    const value = useMemo(\n      () => createCheckedContextValue(parent, available, onViolation),\n      [parent, available],\n    );\n\n    if (!ready) {\n      return fallback;\n    }\n\n    return createElement(\n      ScopeKeysContext.Provider,\n      { value: available },\n      createElement(context.Provider, { value }, children),\n    );\n  }\n\n  return { useSparseSegments, SparseScope: checks ? CheckedSparseScope : SparseScope };\n}\n","import { createSparseReact } from './createSparseReact';\nimport type { SparseReact } from './createSparseReact';\n\nconst defaults: SparseReact = createSparseReact();\n\n/** {@inheritDoc SparseReact.SparseScope} */\nexport const SparseScope: SparseReact['SparseScope'] = defaults.SparseScope;\n\n/** {@inheritDoc SparseReact.useSparseSegments} */\nexport const useSparseSegments: SparseReact['useSparseSegments'] = defaults.useSparseSegments;\n\nexport { createSparseReact } from './createSparseReact';\nexport type { SparseReact, SparseReactOptions, SparseScopeProps } from './createSparseReact';\nexport { getReactReduxContext } from './reactReduxContext';\nexport type { ScopeViolation, ScopeViolationHandler } from './scopeChecks';\nexport type { ReactReduxContextLike, ReactReduxContextValueLike } from './reactReduxContext';\n"],"mappings":"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"}

package/dist/react.mjs

@@ -0,0 +1,185 @@
+import { n as isSegmentKey } from "./segment-DFAgPcwA.mjs";
+import { createContext, createElement, useContext, useEffect, useLayoutEffect, useMemo, useReducer } from "react";
+//#region src/react/reactReduxContext.ts
+const contextKey = Symbol.for("react-redux-context");
+/**
+* The context react-redux's `<Provider>` fills. React-redux keeps it in a
+* registry on `globalThis`, keyed by the React instance, so that every copy
+* of react-redux shares it; reading the same registry finds it without a
+* dependency on any particular build of react-redux.
+*/
+function getReactReduxContext() {
+	var _registry$contextKey;
+	const registry = globalThis;
+	const contexts = (_registry$contextKey = registry[contextKey]) !== null && _registry$contextKey !== void 0 ? _registry$contextKey : registry[contextKey] = /* @__PURE__ */ new Map();
+	let context = contexts.get(createContext);
+	if (!context) {
+		context = createContext(null);
+		context.displayName = "ReactRedux";
+		contexts.set(createContext, context);
+	}
+	return context;
+}
+//#endregion
+//#region src/react/scopeChecks.ts
+/** The segment keys the enclosing scopes hold, with their dependencies. */
+const ScopeKeysContext = createContext(/* @__PURE__ */ new Set());
+const baseListenerKey = Symbol("redux-sparse-kit.baseListener");
+const baseStoreKey = Symbol("redux-sparse-kit.baseStore");
+/** Whether this selector and key were seen before; records them if not. */
+const seenBefore = (reported, selector, key) => {
+	let keys = reported.get(selector);
+	if (!keys) {
+		keys = /* @__PURE__ */ new Set();
+		reported.set(selector, keys);
+	}
+	if (keys.has(key)) return true;
+	keys.add(key);
+	return false;
+};
+const reportedByDefault = /* @__PURE__ */ new Map();
+/** Logs each key once per selector, across all scopes. */
+const reportViolationOnce = ({ key, selector, scope }) => {
+	if (seenBefore(reportedByDefault, selector, key)) return;
+	const reader = selector ? `Selector "${selector.name || "anonymous"}"` : "A selector";
+	const available = scope.length > 0 ? scope.map((name) => `"${name}"`).join(", ") : "none";
+	console.error(`redux-sparse-kit: ${reader} read state.${key} outside every SparseScope holding "${key}" (segments available here: ${available}).`);
+};
+const createScopedStore = (parent, check) => {
+	var _parent$baseStoreKey;
+	const store = (_parent$baseStoreKey = parent[baseStoreKey]) !== null && _parent$baseStoreKey !== void 0 ? _parent$baseStoreKey : parent;
+	const proxies = /* @__PURE__ */ new WeakMap();
+	return {
+		...store,
+		[baseStoreKey]: store,
+		getState() {
+			const state = store.getState();
+			let proxy = proxies.get(state);
+			if (!proxy) {
+				proxy = new Proxy(state, { get(target, property, receiver) {
+					if (typeof property === "string") check(property);
+					return Reflect.get(target, property, receiver);
+				} });
+				proxies.set(state, proxy);
+			}
+			return proxy;
+		}
+	};
+};
+/**
+* The react-redux context value a scope passes down: it checks every state
+* read below it against the segment keys available there.
+*/
+function createCheckedContextValue(parent, available, report) {
+	const reported = /* @__PURE__ */ new Map();
+	const check = (key, selector) => {
+		if (isSegmentKey(key) && !available.has(key) && !seenBefore(reported, selector, key)) report({
+			key,
+			selector,
+			scope: [...available]
+		});
+	};
+	if (parent.stateAccessTracking === true) {
+		const base = baseListenerKey in parent ? parent[baseListenerKey] : parent.onStateAccess;
+		const onStateAccess = (key, selector) => {
+			check(key, selector);
+			base === null || base === void 0 || base(key, selector);
+		};
+		return {
+			...parent,
+			onStateAccess,
+			[baseListenerKey]: base
+		};
+	}
+	return {
+		...parent,
+		store: createScopedStore(parent.store, (key) => check(key, void 0))
+	};
+}
+//#endregion
+//#region src/react/createSparseReact.ts
+const useIsomorphicLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+const segmentIds = /* @__PURE__ */ new WeakMap();
+let nextSegmentId = 0;
+/** Identifies a list of segments by the identity of its members. */
+const signatureOf = (segments) => segments.map((segment) => {
+	let id = segmentIds.get(segment);
+	if (id === void 0) {
+		id = nextSegmentId++;
+		segmentIds.set(segment, id);
+	}
+	return id;
+}).join(",");
+/**
+* The same array for as long as it holds the same segments, so that a new
+* array literal on every render does not acquire them again.
+*/
+const useStableSegments = (segments) => {
+	const signature = signatureOf(segments);
+	return useMemo(() => segments, [signature]);
+};
+const collectKeys = (segments, keys) => {
+	for (const segment of segments) {
+		keys.add(segment.key);
+		collectKeys(segment.deps, keys);
+	}
+};
+/** Creates the React bindings for stores made with `sparseEnhancer`. */
+function createSparseReact(options = {}) {
+	const { checks = process.env.NODE_ENV !== "production", onViolation = reportViolationOnce } = options;
+	const getContext = () => {
+		var _options$context;
+		return (_options$context = options.context) !== null && _options$context !== void 0 ? _options$context : getReactReduxContext();
+	};
+	const useSparseController = () => {
+		const value = useContext(getContext());
+		if (!value) throw new Error("redux-sparse-kit needs a react-redux <Provider> above this component");
+		if (!value.store.sparse) throw new Error("redux-sparse-kit needs a store created with sparseEnhancer");
+		return value.store.sparse;
+	};
+	const useSparseSegments = (segments) => {
+		const sparse = useSparseController();
+		const [, rerender] = useReducer((count) => count + 1, 0);
+		const ready = segments.every((segment) => sparse.has(segment));
+		const stable = useStableSegments(segments);
+		useIsomorphicLayoutEffect(() => {
+			const release = sparse.acquire(...stable);
+			if (!ready) rerender();
+			return release;
+		}, [sparse, stable]);
+		return ready;
+	};
+	function SparseScope({ segments, fallback = null, children }) {
+		return useSparseSegments(segments) ? children : fallback;
+	}
+	function CheckedSparseScope({ segments, fallback = null, children }) {
+		const ready = useSparseSegments(segments);
+		const context = getContext();
+		const parent = useContext(context);
+		const parentKeys = useContext(ScopeKeysContext);
+		const stable = useStableSegments(segments);
+		const available = useMemo(() => {
+			const keys = new Set(parentKeys);
+			collectKeys(stable, keys);
+			return keys;
+		}, [parentKeys, stable]);
+		const value = useMemo(() => createCheckedContextValue(parent, available, onViolation), [parent, available]);
+		if (!ready) return fallback;
+		return createElement(ScopeKeysContext.Provider, { value: available }, createElement(context.Provider, { value }, children));
+	}
+	return {
+		useSparseSegments,
+		SparseScope: checks ? CheckedSparseScope : SparseScope
+	};
+}
+//#endregion
+//#region src/react/index.ts
+const defaults = createSparseReact();
+/** {@inheritDoc SparseReact.SparseScope} */
+const SparseScope = defaults.SparseScope;
+/** {@inheritDoc SparseReact.useSparseSegments} */
+const useSparseSegments = defaults.useSparseSegments;
+//#endregion
+export { SparseScope, createSparseReact, getReactReduxContext, useSparseSegments };
+
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react/reactReduxContext.ts","../src/react/scopeChecks.ts","../src/react/createSparseReact.ts","../src/react/index.ts"],"sourcesContent":["import type { Context } from 'react';\nimport { createContext } from 'react';\nimport type { Store } from 'redux';\nimport type { SparseStoreExt } from '../sparseEnhancer';\n\n/** The parts of a react-redux context value this package relies on. */\nexport interface ReactReduxContextValueLike {\n  store: Store & Partial<SparseStoreExt>;\n  [key: string]: unknown;\n}\n\nexport type ReactReduxContextLike = Context<ReactReduxContextValueLike | null>;\n\nconst contextKey = Symbol.for('react-redux-context');\n\ntype ContextRegistry = Map<typeof createContext, ReactReduxContextLike>;\n\n/**\n * The context react-redux's `<Provider>` fills. React-redux keeps it in a\n * registry on `globalThis`, keyed by the React instance, so that every copy\n * of react-redux shares it; reading the same registry finds it without a\n * dependency on any particular build of react-redux.\n */\nexport function getReactReduxContext(): ReactReduxContextLike {\n  const registry = globalThis as { [contextKey]?: ContextRegistry };\n  const contexts = (registry[contextKey] ??= new Map());\n  let context = contexts.get(createContext);\n\n  if (!context) {\n    context = createContext<ReactReduxContextValueLike | null>(null);\n    context.displayName = 'ReactRedux';\n    contexts.set(createContext, context);\n  }\n\n  return context;\n}\n","import type { Context } from 'react';\nimport { createContext } from 'react';\nimport type { Store } from 'redux';\nimport { isSegmentKey } from '../segment';\nimport type { ReactReduxContextValueLike } from './reactReduxContext';\n\n/** A read of a segment's slice made outside every scope that holds it. */\nexport interface ScopeViolation {\n  /** The key of the segment slice that was read. */\n  key: string;\n  /**\n   * The selector that read it, when react-redux reports reads through\n   * `onStateAccess`; otherwise `undefined`.\n   */\n  selector: Function | undefined;\n  /** The segment keys available where it was read. */\n  scope: readonly string[];\n}\n\nexport type ScopeViolationHandler = (violation: ScopeViolation) => void;\n\ntype StateAccessListener = (key: string, selector: Function) => void;\n\n/** The segment keys the enclosing scopes hold, with their dependencies. */\nexport const ScopeKeysContext: Context<ReadonlySet<string>> = createContext<ReadonlySet<string>>(\n  new Set(),\n);\n\n// The listener a scope found in place, so that nested scopes call it instead\n// of the listener of the scope around them.\nconst baseListenerKey: unique symbol = Symbol('redux-sparse-kit.baseListener');\n\n// The store a scoped store wraps, so that nested scopes wrap the original\n// store rather than the scoped store of the scope around them.\nconst baseStoreKey: unique symbol = Symbol('redux-sparse-kit.baseStore');\n\ninterface CheckedContextValue extends ReactReduxContextValueLike {\n  [baseListenerKey]?: StateAccessListener | undefined;\n}\n\ntype ScopedStore = Store & { [baseStoreKey]?: Store };\n\ntype Reported = Map<Function | undefined, Set<string>>;\n\n/** Whether this selector and key were seen before; records them if not. */\nconst seenBefore = (reported: Reported, selector: Function | undefined, key: string) => {\n  let keys = reported.get(selector);\n  if (!keys) {\n    keys = new Set();\n    reported.set(selector, keys);\n  }\n\n  if (keys.has(key)) {\n    return true;\n  }\n  keys.add(key);\n  return false;\n};\n\nconst reportedByDefault: Reported = new Map();\n\n/** Logs each key once per selector, across all scopes. */\nexport const reportViolationOnce: ScopeViolationHandler = ({ key, selector, scope }) => {\n  if (seenBefore(reportedByDefault, selector, key)) {\n    return;\n  }\n\n  const reader = selector ? `Selector \"${selector.name || 'anonymous'}\"` : 'A selector';\n  const available = scope.length > 0 ? scope.map((name) => `\"${name}\"`).join(', ') : 'none';\n\n  console.error(\n    `redux-sparse-kit: ${reader} read state.${key} outside every SparseScope holding \"${key}\" ` +\n      `(segments available here: ${available}).`,\n  );\n};\n\nconst createScopedStore = (parent: ScopedStore, check: (key: string) => void): ScopedStore => {\n  const store = parent[baseStoreKey] ?? parent;\n  const proxies = new WeakMap<object, object>();\n\n  return {\n    ...store,\n    [baseStoreKey]: store,\n    getState() {\n      // Always an object: the root state of a store made with sparseEnhancer.\n      const state = store.getState() as object;\n\n      let proxy = proxies.get(state);\n      if (!proxy) {\n        proxy = new Proxy(state, {\n          get(target, property, receiver) {\n            if (typeof property === 'string') {\n              check(property);\n            }\n            return Reflect.get(target, property, receiver);\n          },\n        });\n        proxies.set(state, proxy);\n      }\n      return proxy;\n    },\n  };\n};\n\n/**\n * The react-redux context value a scope passes down: it checks every state\n * read below it against the segment keys available there.\n */\nexport function createCheckedContextValue(\n  parent: CheckedContextValue,\n  available: ReadonlySet<string>,\n  report: ScopeViolationHandler,\n): CheckedContextValue {\n  const reported: Reported = new Map();\n\n  // Each scope reports a selector reading a key once, however often it runs.\n  const check = (key: string, selector: Function | undefined) => {\n    if (isSegmentKey(key) && !available.has(key) && !seenBefore(reported, selector, key)) {\n      report({ key, selector, scope: [...available] });\n    }\n  };\n\n  if (parent.stateAccessTracking === true) {\n    const base =\n      baseListenerKey in parent\n        ? parent[baseListenerKey]\n        : (parent.onStateAccess as StateAccessListener | undefined);\n\n    const onStateAccess: StateAccessListener = (key, selector) => {\n      check(key, selector);\n      base?.(key, selector);\n    };\n\n    return { ...parent, onStateAccess, [baseListenerKey]: base };\n  }\n\n  return {\n    ...parent,\n    store: createScopedStore(parent.store, (key) => check(key, undefined)),\n  };\n}\n","import type { ReactNode } from 'react';\nimport { createElement, useContext, useEffect, useLayoutEffect, useMemo, useReducer } from 'react';\nimport type { AnySegment } from '../segment';\nimport type { SparseController } from '../sparseEnhancer';\nimport type { ReactReduxContextLike } from './reactReduxContext';\nimport { getReactReduxContext } from './reactReduxContext';\nimport type { ScopeViolationHandler } from './scopeChecks';\nimport { createCheckedContextValue, reportViolationOnce, ScopeKeysContext } from './scopeChecks';\n\n// Layout effects do not run on the server, and React warns about them there.\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\nconst segmentIds = new WeakMap<AnySegment, number>();\nlet nextSegmentId = 0;\n\n/** Identifies a list of segments by the identity of its members. */\nconst signatureOf = (segments: readonly AnySegment[]) =>\n  segments\n    .map((segment) => {\n      let id = segmentIds.get(segment);\n      if (id === undefined) {\n        id = nextSegmentId++;\n        segmentIds.set(segment, id);\n      }\n      return id;\n    })\n    .join(',');\n\n/**\n * The same array for as long as it holds the same segments, so that a new\n * array literal on every render does not acquire them again.\n */\nconst useStableSegments = (segments: readonly AnySegment[]) => {\n  const signature = signatureOf(segments);\n  // oxlint-disable-next-line react-hooks/exhaustive-deps -- tracked by their signature\n  return useMemo(() => segments, [signature]);\n};\n\nconst collectKeys = (segments: readonly AnySegment[], keys: Set<string>) => {\n  for (const segment of segments) {\n    keys.add(segment.key);\n    collectKeys(segment.deps, keys);\n  }\n};\n\nexport interface SparseReactOptions {\n  /**\n   * The context the react-redux `<Provider>` was given. Defaults to\n   * react-redux's own context.\n   */\n  context?: ReactReduxContextLike;\n  /**\n   * Checks that components read segment slices only inside a scope that holds\n   * them. Defaults to `true` outside production builds.\n   */\n  checks?: boolean;\n  /**\n   * Called for each read of a segment slice outside the scopes that hold it.\n   * Defaults to logging each key once per selector with `console.error`.\n   */\n  onViolation?: ScopeViolationHandler;\n}\n\nexport interface SparseScopeProps {\n  /** Segments held for as long as the scope is mounted. */\n  segments: readonly AnySegment[];\n  /** Rendered until the segments are present in the store. */\n  fallback?: ReactNode;\n  children?: ReactNode;\n}\n\nexport interface SparseReact {\n  /**\n   * Holds `segments` for as long as the calling component is mounted and\n   * returns whether they are all present in the store yet.\n   */\n  useSparseSegments(segments: readonly AnySegment[]): boolean;\n  /**\n   * Holds `segments` for as long as it is mounted, and renders its children\n   * only once they are present in the store. With checks on, reads of segment\n   * slices below it that no enclosing scope holds are reported; a scope with\n   * no segments checks the reads below it that no scope holds at all.\n   */\n  SparseScope(props: SparseScopeProps): ReactNode;\n}\n\n/** Creates the React bindings for stores made with `sparseEnhancer`. */\nexport function createSparseReact(options: SparseReactOptions = {}): SparseReact {\n  const { checks = process.env.NODE_ENV !== 'production', onViolation = reportViolationOnce } =\n    options;\n\n  const getContext = () => options.context ?? getReactReduxContext();\n\n  const useSparseController = (): SparseController => {\n    const value = useContext(getContext());\n\n    if (!value) {\n      throw new Error('redux-sparse-kit needs a react-redux <Provider> above this component');\n    }\n\n    if (!value.store.sparse) {\n      throw new Error('redux-sparse-kit needs a store created with sparseEnhancer');\n    }\n\n    return value.store.sparse;\n  };\n\n  const useSparseSegments = (segments: readonly AnySegment[]): boolean => {\n    const sparse = useSparseController();\n    const [, rerender] = useReducer((count: number) => count + 1, 0);\n    const ready = segments.every((segment) => sparse.has(segment));\n    const stable = useStableSegments(segments);\n\n    useIsomorphicLayoutEffect(() => {\n      const release = sparse.acquire(...stable);\n      if (!ready) {\n        // Rendered before they were injected: render again, before paint.\n        rerender();\n      }\n      return release;\n    }, [sparse, stable]);\n\n    return ready;\n  };\n\n  function SparseScope({ segments, fallback = null, children }: SparseScopeProps): ReactNode {\n    return useSparseSegments(segments) ? children : fallback;\n  }\n\n  function CheckedSparseScope({\n    segments,\n    fallback = null,\n    children,\n  }: SparseScopeProps): ReactNode {\n    const ready = useSparseSegments(segments);\n    const context = getContext();\n    const parent = useContext(context)!;\n    const parentKeys = useContext(ScopeKeysContext);\n    const stable = useStableSegments(segments);\n\n    const available = useMemo(() => {\n      const keys = new Set(parentKeys);\n      collectKeys(stable, keys);\n      return keys;\n    }, [parentKeys, stable]);\n\n    const value = useMemo(\n      () => createCheckedContextValue(parent, available, onViolation),\n      [parent, available],\n    );\n\n    if (!ready) {\n      return fallback;\n    }\n\n    return createElement(\n      ScopeKeysContext.Provider,\n      { value: available },\n      createElement(context.Provider, { value }, children),\n    );\n  }\n\n  return { useSparseSegments, SparseScope: checks ? CheckedSparseScope : SparseScope };\n}\n","import { createSparseReact } from './createSparseReact';\nimport type { SparseReact } from './createSparseReact';\n\nconst defaults: SparseReact = createSparseReact();\n\n/** {@inheritDoc SparseReact.SparseScope} */\nexport const SparseScope: SparseReact['SparseScope'] = defaults.SparseScope;\n\n/** {@inheritDoc SparseReact.useSparseSegments} */\nexport const useSparseSegments: SparseReact['useSparseSegments'] = defaults.useSparseSegments;\n\nexport { createSparseReact } from './createSparseReact';\nexport type { SparseReact, SparseReactOptions, SparseScopeProps } from './createSparseReact';\nexport { getReactReduxContext } from './reactReduxContext';\nexport type { ScopeViolation, ScopeViolationHandler } from './scopeChecks';\nexport type { ReactReduxContextLike, ReactReduxContextValueLike } from './reactReduxContext';\n"],"mappings":"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"}

package/dist/segment-DFAgPcwA.mjs

@@ -0,0 +1,33 @@
+//#region src/segment.ts
+const definedKeys = /* @__PURE__ */ new Set();
+/**
+* Whether a segment with a reducer has been defined under this key. Lets dev
+* checks tell a read of a segment's slice from a read of static state.
+*/
+const isSegmentKey = (key) => definedKeys.has(key);
+/**
+* Defines a segment: a reducer, the epics that drive it and the segments it
+* depends on, injected together and evicted together. Each part is optional.
+*
+* A dependency has to be defined before the segment that lists it, so the
+* dependency graph cannot contain a cycle.
+*/
+function defineSegment(options) {
+	const { key, reducer, deps = [], epics = [], idleTimeout, whileIdle } = options;
+	if (typeof key !== "string" || key === "") throw new TypeError("A segment key must be a non-empty string");
+	if (reducer !== void 0 && typeof reducer !== "function") throw new TypeError(`The reducer of segment "${key}" must be a function`);
+	if (idleTimeout !== void 0 && !(idleTimeout >= 0)) throw new RangeError(`The idle timeout of segment "${key}" must be a non-negative number`);
+	if (reducer !== void 0) definedKeys.add(key);
+	return Object.freeze({
+		key,
+		reducer,
+		deps: Object.freeze([...deps]),
+		epics: Object.freeze([...epics]),
+		idleTimeout,
+		whileIdle
+	});
+}
+//#endregion
+export { isSegmentKey as n, defineSegment as t };
+
+//# sourceMappingURL=segment-DFAgPcwA.mjs.map

package/dist/segment-DFAgPcwA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-DFAgPcwA.mjs","names":[],"sources":["../src/segment.ts"],"sourcesContent":["import type { Reducer } from 'redux';\n\n/**\n * The state that is always present in the store, outside of any segment.\n * Register it once so that segment epics can read it:\n *\n * ```ts\n * declare module 'redux-sparse-kit' {\n *   interface StaticState extends RootStaticState {}\n * }\n * ```\n */\n// oxlint-disable-next-line typescript/no-empty-interface, typescript/no-empty-object-type\nexport interface StaticState {}\n\n/**\n * What an idle segment (one no longer held by anything) does until it is\n * evicted:\n * - `keep-running` - its reducer and epics keep running, so its state stays\n *   current.\n * - `pause-epics` - its reducer keeps running, its epics are stopped and\n *   started again when the segment is held again.\n * - `freeze` - its epics are stopped and its reducer is skipped, so its state\n *   is kept exactly as it was.\n */\nexport type WhileIdle = 'keep-running' | 'pause-epics' | 'freeze';\n\n/**\n * An epic as far as the core is concerned: a function the epic runner starts.\n * The `redux-sparse-kit/observable` entry point runs redux-observable epics.\n */\nexport type SegmentEpic = (...args: any[]) => unknown;\n\n/**\n * A reducer, the epics that drive it and the segments it depends on, injected\n * together and evicted together. Its `State` is `never` when it has no\n * reducer: it then owns no slice of the state.\n */\nexport interface Segment<\n  Key extends string = string,\n  State = any,\n  Deps extends readonly AnySegment[] = readonly AnySegment[],\n> {\n  /**\n   * Names the segment, and is the top-level key of the state its reducer\n   * owns when it has one.\n   */\n  readonly key: Key;\n  readonly reducer: unknown extends State\n    ? Reducer<any> | undefined\n    : [State] extends [never]\n      ? undefined\n      : Reducer<State>;\n  /** Segments that must be present for as long as this one is. */\n  readonly deps: Deps;\n  readonly epics: readonly SegmentEpic[];\n  /** Overrides the store's idle timeout for this segment, in milliseconds. */\n  readonly idleTimeout: number | undefined;\n  /** Overrides the store's idle behaviour for this segment. */\n  readonly whileIdle: WhileIdle | undefined;\n}\n\n/**\n * Any segment, with or without a reducer. Spelled out rather than written as\n * `Segment<string, any>`, which a segment without a reducer would not match.\n */\nexport interface AnySegment {\n  readonly key: string;\n  readonly reducer: Reducer<any> | undefined;\n  readonly deps: readonly AnySegment[];\n  readonly epics: readonly SegmentEpic[];\n  readonly idleTimeout: number | undefined;\n  readonly whileIdle: WhileIdle | undefined;\n}\n\ntype SliceKeyOf<S> =\n  S extends Segment<infer Key, infer State, any> ? ([State] extends [never] ? never : Key) : never;\n\n/**\n * The state slice each of the given segments contributes to the store;\n * segments without a reducer contribute none.\n */\nexport type StateOfSegments<Segments extends AnySegment> = {\n  [S in Segments as SliceKeyOf<S>]: S extends Segment<string, infer State, any> ? State : never;\n};\n\ntype OwnSliceOf<Key extends string, State> = [State] extends [never] ? {} : { [K in Key]: State };\n\n/**\n * The state a segment may read: the static state, its own slice and the\n * slices of its direct dependencies.\n */\nexport type ScopeStateOf<S extends AnySegment> = StaticState &\n  StateOfSegments<S | S['deps'][number]>;\n\ntype EpicStateOf<Epic> = Epic extends (action$: any, state$: infer State$, ...rest: any[]) => any\n  ? State$ extends { readonly value: infer State }\n    ? State\n    : unknown\n  : unknown;\n\ndeclare const segmentEpicError: unique symbol;\n\n/**\n * Shown when an epic declares a state the segment cannot guarantee: it reads\n * a segment that is neither the segment itself nor one of its dependencies.\n */\nexport interface SegmentEpicStateError<Readable, Declared> {\n  readonly [segmentEpicError]: 'The epic reads state outside the segment and its deps';\n  readonly readable: Readable;\n  readonly declared: Declared;\n}\n\n/** An epic typed with a `void`, `unknown` or `any` state does not read it. */\ntype ReadsState<State> = [State] extends [void] ? false : unknown extends State ? false : true;\n\ntype ValidateEpics<Epics extends readonly unknown[], Scope> = {\n  [I in keyof Epics]: ReadsState<EpicStateOf<Epics[I]>> extends false\n    ? unknown\n    : Scope extends EpicStateOf<Epics[I]>\n      ? unknown\n      : SegmentEpicStateError<Scope, EpicStateOf<Epics[I]>>;\n};\n\nexport interface SegmentOptions<\n  Key extends string,\n  State,\n  Deps extends readonly AnySegment[],\n  Epics extends readonly SegmentEpic[],\n> {\n  key: Key;\n  /** Omitted for a segment that only runs epics or only bundles its deps. */\n  reducer?: Reducer<State>;\n  deps?: Deps;\n  epics?: Epics &\n    ValidateEpics<Epics, StaticState & StateOfSegments<Deps[number]> & OwnSliceOf<Key, State>>;\n  idleTimeout?: number;\n  whileIdle?: WhileIdle;\n}\n\nconst definedKeys = new Set<string>();\n\n/**\n * Whether a segment with a reducer has been defined under this key. Lets dev\n * checks tell a read of a segment's slice from a read of static state.\n */\nexport const isSegmentKey = (key: string): boolean => definedKeys.has(key);\n\n/**\n * Defines a segment: a reducer, the epics that drive it and the segments it\n * depends on, injected together and evicted together. Each part is optional.\n *\n * A dependency has to be defined before the segment that lists it, so the\n * dependency graph cannot contain a cycle.\n */\nexport function defineSegment<\n  const Key extends string,\n  State = never,\n  const Deps extends readonly AnySegment[] = [],\n  const Epics extends readonly SegmentEpic[] = [],\n>(options: SegmentOptions<Key, State, Deps, Epics>): Segment<Key, State, Deps> {\n  const {\n    key,\n    reducer,\n    deps = [] as unknown as Deps,\n    epics = [],\n    idleTimeout,\n    whileIdle,\n  } = options;\n\n  if (typeof key !== 'string' || key === '') {\n    throw new TypeError('A segment key must be a non-empty string');\n  }\n\n  if (reducer !== undefined && typeof reducer !== 'function') {\n    throw new TypeError(`The reducer of segment \"${key}\" must be a function`);\n  }\n\n  if (idleTimeout !== undefined && !(idleTimeout >= 0)) {\n    throw new RangeError(`The idle timeout of segment \"${key}\" must be a non-negative number`);\n  }\n\n  if (reducer !== undefined) {\n    definedKeys.add(key);\n  }\n\n  const segment = Object.freeze({\n    key,\n    reducer,\n    deps: Object.freeze([...deps]) as unknown as Deps,\n    epics: Object.freeze([...(epics as readonly SegmentEpic[])]),\n    idleTimeout,\n    whileIdle,\n  });\n\n  return segment as Segment<Key, State, Deps>;\n}\n"],"mappings":";AA4IA,MAAM,8BAAc,IAAI,IAAY;;;;;AAMpC,MAAa,gBAAgB,QAAyB,YAAY,IAAI,GAAG;;;;;;;;AASzE,SAAgB,cAKd,SAA6E;CAC7E,MAAM,EACJ,KACA,SACA,OAAO,CAAC,GACR,QAAQ,CAAC,GACT,aACA,cACE;CAEJ,IAAI,OAAO,QAAQ,YAAY,QAAQ,IACrC,MAAM,IAAI,UAAU,0CAA0C;CAGhE,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,YAC9C,MAAM,IAAI,UAAU,2BAA2B,IAAI,qBAAqB;CAG1E,IAAI,gBAAgB,KAAA,KAAa,EAAE,eAAe,IAChD,MAAM,IAAI,WAAW,gCAAgC,IAAI,gCAAgC;CAG3F,IAAI,YAAY,KAAA,GACd,YAAY,IAAI,GAAG;CAYrB,OATgB,OAAO,OAAO;EAC5B;EACA;EACA,MAAM,OAAO,OAAO,CAAC,GAAG,IAAI,CAAC;EAC7B,OAAO,OAAO,OAAO,CAAC,GAAI,KAAgC,CAAC;EAC3D;EACA;CACF,CAEa;AACf"}

package/dist/segment-Dqd6-ABS.js

@@ -0,0 +1,44 @@
+//#region src/segment.ts
+const definedKeys = /* @__PURE__ */ new Set();
+/**
+* Whether a segment with a reducer has been defined under this key. Lets dev
+* checks tell a read of a segment's slice from a read of static state.
+*/
+const isSegmentKey = (key) => definedKeys.has(key);
+/**
+* Defines a segment: a reducer, the epics that drive it and the segments it
+* depends on, injected together and evicted together. Each part is optional.
+*
+* A dependency has to be defined before the segment that lists it, so the
+* dependency graph cannot contain a cycle.
+*/
+function defineSegment(options) {
+	const { key, reducer, deps = [], epics = [], idleTimeout, whileIdle } = options;
+	if (typeof key !== "string" || key === "") throw new TypeError("A segment key must be a non-empty string");
+	if (reducer !== void 0 && typeof reducer !== "function") throw new TypeError(`The reducer of segment "${key}" must be a function`);
+	if (idleTimeout !== void 0 && !(idleTimeout >= 0)) throw new RangeError(`The idle timeout of segment "${key}" must be a non-negative number`);
+	if (reducer !== void 0) definedKeys.add(key);
+	return Object.freeze({
+		key,
+		reducer,
+		deps: Object.freeze([...deps]),
+		epics: Object.freeze([...epics]),
+		idleTimeout,
+		whileIdle
+	});
+}
+//#endregion
+Object.defineProperty(exports, "defineSegment", {
+	enumerable: true,
+	get: function() {
+		return defineSegment;
+	}
+});
+Object.defineProperty(exports, "isSegmentKey", {
+	enumerable: true,
+	get: function() {
+		return isSegmentKey;
+	}
+});
+
+//# sourceMappingURL=segment-Dqd6-ABS.js.map

package/dist/segment-Dqd6-ABS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-Dqd6-ABS.js","names":[],"sources":["../src/segment.ts"],"sourcesContent":["import type { Reducer } from 'redux';\n\n/**\n * The state that is always present in the store, outside of any segment.\n * Register it once so that segment epics can read it:\n *\n * ```ts\n * declare module 'redux-sparse-kit' {\n *   interface StaticState extends RootStaticState {}\n * }\n * ```\n */\n// oxlint-disable-next-line typescript/no-empty-interface, typescript/no-empty-object-type\nexport interface StaticState {}\n\n/**\n * What an idle segment (one no longer held by anything) does until it is\n * evicted:\n * - `keep-running` - its reducer and epics keep running, so its state stays\n *   current.\n * - `pause-epics` - its reducer keeps running, its epics are stopped and\n *   started again when the segment is held again.\n * - `freeze` - its epics are stopped and its reducer is skipped, so its state\n *   is kept exactly as it was.\n */\nexport type WhileIdle = 'keep-running' | 'pause-epics' | 'freeze';\n\n/**\n * An epic as far as the core is concerned: a function the epic runner starts.\n * The `redux-sparse-kit/observable` entry point runs redux-observable epics.\n */\nexport type SegmentEpic = (...args: any[]) => unknown;\n\n/**\n * A reducer, the epics that drive it and the segments it depends on, injected\n * together and evicted together. Its `State` is `never` when it has no\n * reducer: it then owns no slice of the state.\n */\nexport interface Segment<\n  Key extends string = string,\n  State = any,\n  Deps extends readonly AnySegment[] = readonly AnySegment[],\n> {\n  /**\n   * Names the segment, and is the top-level key of the state its reducer\n   * owns when it has one.\n   */\n  readonly key: Key;\n  readonly reducer: unknown extends State\n    ? Reducer<any> | undefined\n    : [State] extends [never]\n      ? undefined\n      : Reducer<State>;\n  /** Segments that must be present for as long as this one is. */\n  readonly deps: Deps;\n  readonly epics: readonly SegmentEpic[];\n  /** Overrides the store's idle timeout for this segment, in milliseconds. */\n  readonly idleTimeout: number | undefined;\n  /** Overrides the store's idle behaviour for this segment. */\n  readonly whileIdle: WhileIdle | undefined;\n}\n\n/**\n * Any segment, with or without a reducer. Spelled out rather than written as\n * `Segment<string, any>`, which a segment without a reducer would not match.\n */\nexport interface AnySegment {\n  readonly key: string;\n  readonly reducer: Reducer<any> | undefined;\n  readonly deps: readonly AnySegment[];\n  readonly epics: readonly SegmentEpic[];\n  readonly idleTimeout: number | undefined;\n  readonly whileIdle: WhileIdle | undefined;\n}\n\ntype SliceKeyOf<S> =\n  S extends Segment<infer Key, infer State, any> ? ([State] extends [never] ? never : Key) : never;\n\n/**\n * The state slice each of the given segments contributes to the store;\n * segments without a reducer contribute none.\n */\nexport type StateOfSegments<Segments extends AnySegment> = {\n  [S in Segments as SliceKeyOf<S>]: S extends Segment<string, infer State, any> ? State : never;\n};\n\ntype OwnSliceOf<Key extends string, State> = [State] extends [never] ? {} : { [K in Key]: State };\n\n/**\n * The state a segment may read: the static state, its own slice and the\n * slices of its direct dependencies.\n */\nexport type ScopeStateOf<S extends AnySegment> = StaticState &\n  StateOfSegments<S | S['deps'][number]>;\n\ntype EpicStateOf<Epic> = Epic extends (action$: any, state$: infer State$, ...rest: any[]) => any\n  ? State$ extends { readonly value: infer State }\n    ? State\n    : unknown\n  : unknown;\n\ndeclare const segmentEpicError: unique symbol;\n\n/**\n * Shown when an epic declares a state the segment cannot guarantee: it reads\n * a segment that is neither the segment itself nor one of its dependencies.\n */\nexport interface SegmentEpicStateError<Readable, Declared> {\n  readonly [segmentEpicError]: 'The epic reads state outside the segment and its deps';\n  readonly readable: Readable;\n  readonly declared: Declared;\n}\n\n/** An epic typed with a `void`, `unknown` or `any` state does not read it. */\ntype ReadsState<State> = [State] extends [void] ? false : unknown extends State ? false : true;\n\ntype ValidateEpics<Epics extends readonly unknown[], Scope> = {\n  [I in keyof Epics]: ReadsState<EpicStateOf<Epics[I]>> extends false\n    ? unknown\n    : Scope extends EpicStateOf<Epics[I]>\n      ? unknown\n      : SegmentEpicStateError<Scope, EpicStateOf<Epics[I]>>;\n};\n\nexport interface SegmentOptions<\n  Key extends string,\n  State,\n  Deps extends readonly AnySegment[],\n  Epics extends readonly SegmentEpic[],\n> {\n  key: Key;\n  /** Omitted for a segment that only runs epics or only bundles its deps. */\n  reducer?: Reducer<State>;\n  deps?: Deps;\n  epics?: Epics &\n    ValidateEpics<Epics, StaticState & StateOfSegments<Deps[number]> & OwnSliceOf<Key, State>>;\n  idleTimeout?: number;\n  whileIdle?: WhileIdle;\n}\n\nconst definedKeys = new Set<string>();\n\n/**\n * Whether a segment with a reducer has been defined under this key. Lets dev\n * checks tell a read of a segment's slice from a read of static state.\n */\nexport const isSegmentKey = (key: string): boolean => definedKeys.has(key);\n\n/**\n * Defines a segment: a reducer, the epics that drive it and the segments it\n * depends on, injected together and evicted together. Each part is optional.\n *\n * A dependency has to be defined before the segment that lists it, so the\n * dependency graph cannot contain a cycle.\n */\nexport function defineSegment<\n  const Key extends string,\n  State = never,\n  const Deps extends readonly AnySegment[] = [],\n  const Epics extends readonly SegmentEpic[] = [],\n>(options: SegmentOptions<Key, State, Deps, Epics>): Segment<Key, State, Deps> {\n  const {\n    key,\n    reducer,\n    deps = [] as unknown as Deps,\n    epics = [],\n    idleTimeout,\n    whileIdle,\n  } = options;\n\n  if (typeof key !== 'string' || key === '') {\n    throw new TypeError('A segment key must be a non-empty string');\n  }\n\n  if (reducer !== undefined && typeof reducer !== 'function') {\n    throw new TypeError(`The reducer of segment \"${key}\" must be a function`);\n  }\n\n  if (idleTimeout !== undefined && !(idleTimeout >= 0)) {\n    throw new RangeError(`The idle timeout of segment \"${key}\" must be a non-negative number`);\n  }\n\n  if (reducer !== undefined) {\n    definedKeys.add(key);\n  }\n\n  const segment = Object.freeze({\n    key,\n    reducer,\n    deps: Object.freeze([...deps]) as unknown as Deps,\n    epics: Object.freeze([...(epics as readonly SegmentEpic[])]),\n    idleTimeout,\n    whileIdle,\n  });\n\n  return segment as Segment<Key, State, Deps>;\n}\n"],"mappings":";AA4IA,MAAM,8BAAc,IAAI,IAAY;;;;;AAMpC,MAAa,gBAAgB,QAAyB,YAAY,IAAI,GAAG;;;;;;;;AASzE,SAAgB,cAKd,SAA6E;CAC7E,MAAM,EACJ,KACA,SACA,OAAO,CAAC,GACR,QAAQ,CAAC,GACT,aACA,cACE;CAEJ,IAAI,OAAO,QAAQ,YAAY,QAAQ,IACrC,MAAM,IAAI,UAAU,0CAA0C;CAGhE,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,YAC9C,MAAM,IAAI,UAAU,2BAA2B,IAAI,qBAAqB;CAG1E,IAAI,gBAAgB,KAAA,KAAa,EAAE,eAAe,IAChD,MAAM,IAAI,WAAW,gCAAgC,IAAI,gCAAgC;CAG3F,IAAI,YAAY,KAAA,GACd,YAAY,IAAI,GAAG;CAYrB,OATgB,OAAO,OAAO;EAC5B;EACA;EACA,MAAM,OAAO,OAAO,CAAC,GAAG,IAAI,CAAC;EAC7B,OAAO,OAAO,OAAO,CAAC,GAAI,KAAgC,CAAC;EAC3D;EACA;CACF,CAEa;AACf"}