@chelone/core 0.6.0 → 0.7.0

package/dist/router/match.js

@@ -1,45 +1,53 @@
+// src/router/match.ts
+/** Compile a pattern into a case-insensitive regex + ordered param names. */
 function compilePattern(pattern) {
-  const paramNames = [];
-  let regexpSource = `^${pattern.replace(/[\\.*+^${}|()[\]]/g, "\\$&").replace(/\\\*/g, "*").replace(/^\/*/, "/").replace(/\/+$/, "").replace(/\/:(\w+)/g, (_m, name) => {
-    paramNames.push(name);
-    return "/([^\\/]+)";
-  })}`;
-  if (pattern.endsWith("*")) {
-    paramNames.push("*");
-    regexpSource += pattern === "*" || pattern === "/*" ? "(.*)$" : "(?:\\/(.+)|\\/*)$";
-  } else {
-    regexpSource += "\\/*$";
-  }
-  return { matcher: new RegExp(regexpSource, "i"), paramNames };
+	const paramNames = [];
+	let regexpSource = `^${pattern.replace(/[\\.*+^${}|()[\]]/g, "\\$&").replace(/\\\*/g, "*").replace(/^\/*/, "/").replace(/\/+$/, "").replace(/\/:(\w+)/g, (_m, name) => {
+		paramNames.push(name);
+		return "/([^\\/]+)";
+	})}`;
+	if (pattern.endsWith("*")) {
+		paramNames.push("*");
+		regexpSource += pattern === "*" || pattern === "/*" ? "(.*)$" : "(?:\\/(.+)|\\/*)$";
+	} else regexpSource += "\\/*$";
+	return {
+		matcher: new RegExp(regexpSource, "i"),
+		paramNames
+	};
 }
+/** Safe URI-decode: fall back to the raw value on a malformed sequence. */
 function safeDecode(value) {
-  try {
-    return decodeURIComponent(value);
-  } catch {
-    return value;
-  }
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
 }
+/**
+* Match `pathname` against `pattern`. Returns the captured params, the matched
+* `pathname`, and `pathnameBase` (the match minus any splat remainder), or
+* `null` when the pattern does not match.
+*/
 function matchPath(pattern, pathname) {
-  const { matcher, paramNames } = compilePattern(pattern);
-  const match = pathname.match(matcher);
-  if (!match) return null;
-  const matchedPathname = match[0];
-  const hasSplat = paramNames[paramNames.length - 1] === "*";
-  let pathnameBase = matchedPathname;
-  const params = {};
-  paramNames.forEach((name, index) => {
-    if (name === "*") {
-      const splat = match[index + 1] ?? "";
-      pathnameBase = matchedPathname.slice(0, matchedPathname.length - splat.length).replace(/(.)\/+$/, "$1");
-      params["*"] = splat;
-    } else {
-      params[name] = safeDecode(match[index + 1] ?? "");
-    }
-  });
-  if (hasSplat && pathnameBase === "") pathnameBase = "/";
-  const normalizedPathname = matchedPathname.length > 1 ? matchedPathname.replace(/\/+$/, "") : matchedPathname;
-  return { params, pathname: normalizedPathname || "/", pathnameBase };
+	const { matcher, paramNames } = compilePattern(pattern);
+	const match = pathname.match(matcher);
+	if (!match) return null;
+	const matchedPathname = match[0];
+	const hasSplat = paramNames[paramNames.length - 1] === "*";
+	let pathnameBase = matchedPathname;
+	const params = {};
+	paramNames.forEach((name, index) => {
+		if (name === "*") {
+			const splat = match[index + 1] ?? "";
+			pathnameBase = matchedPathname.slice(0, matchedPathname.length - splat.length).replace(/(.)\/+$/, "$1");
+			params["*"] = splat;
+		} else params[name] = safeDecode(match[index + 1] ?? "");
+	});
+	if (hasSplat && pathnameBase === "") pathnameBase = "/";
+	return {
+		params,
+		pathname: (matchedPathname.length > 1 ? matchedPathname.replace(/\/+$/, "") : matchedPathname) || "/",
+		pathnameBase
+	};
 }
-export {
-  matchPath
-};
+export { matchPath };

package/dist/router/paths.js

@@ -1,40 +1,46 @@
+// src/router/paths.ts
+/**
+* Collapse runs of `/` into a single `/`, WITHOUT touching a `scheme://`
+* authority separator. Matches ra-core's `removeDoubleSlashes` for internal
+* paths while staying safe on the rare absolute URL.
+*/
 function removeDoubleSlashes(path) {
-  const schemeMatch = path.match(/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//);
-  if (schemeMatch) {
-    const prefix = schemeMatch[0];
-    return prefix + path.slice(prefix.length).replace(/\/\/+/g, "/");
-  }
-  return path.replace(/\/\/+/g, "/");
+	const schemeMatch = path.match(/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//);
+	if (schemeMatch) {
+		const prefix = schemeMatch[0];
+		return prefix + path.slice(prefix.length).replace(/\/\/+/g, "/");
+	}
+	return path.replace(/\/\/+/g, "/");
 }
+/**
+* Prefix `path` with `basename`, collapsing the seam and any trailing basename
+* slash. An empty basename is a no-op. The result is always slash-normalized.
+*/
 function joinBasename(path, basename = "") {
-  const joined = basename ? `${basename}/${path}` : path;
-  const collapsed = removeDoubleSlashes(joined);
-  return collapsed.length > 1 ? collapsed.replace(/\/$/, "") : collapsed;
+	const collapsed = removeDoubleSlashes(basename ? `${basename}/${path}` : path);
+	return collapsed.length > 1 ? collapsed.replace(/\/$/, "") : collapsed;
 }
+/**
+* Build a route path for a link intent (parity §0a-11):
+* `list`→`/res`, `create`→`/res/create`, `edit`→`/res/:id`, `show`→`/res/:id/show`.
+* `id==null` on `edit`/`show` falls back to the list path. The id is
+* `encodeURIComponent`d, and double slashes are removed from these four known
+* intents. A custom string `type` is returned COMPLETELY verbatim — NO basename
+* prefix, NO slash collapse — matching ra-core's `useCreatePath` `default`
+* branch (the author owns the full, final path).
+*/
 function createPath(params, basename = "") {
-  const { type, resource, id } = params;
-  switch (type) {
-    case "list":
-      return joinBasename(`/${resource}`, basename);
-    case "create":
-      return joinBasename(`/${resource}/create`, basename);
-    case "edit": {
-      if (id == null) return joinBasename(`/${resource}`, basename);
-      return joinBasename(`/${resource}/${encodeURIComponent(id)}`, basename);
-    }
-    case "show": {
-      if (id == null) return joinBasename(`/${resource}`, basename);
-      return joinBasename(
-        `/${resource}/${encodeURIComponent(id)}/show`,
-        basename
-      );
-    }
-    default:
-      return type;
-  }
+	const { type, resource, id } = params;
+	switch (type) {
+		case "list": return joinBasename(`/${resource}`, basename);
+		case "create": return joinBasename(`/${resource}/create`, basename);
+		case "edit":
+			if (id == null) return joinBasename(`/${resource}`, basename);
+			return joinBasename(`/${resource}/${encodeURIComponent(id)}`, basename);
+		case "show":
+			if (id == null) return joinBasename(`/${resource}`, basename);
+			return joinBasename(`/${resource}/${encodeURIComponent(id)}/show`, basename);
+		default: return type;
+	}
 }
-export {
-  createPath,
-  joinBasename,
-  removeDoubleSlashes
-};
+export { createPath, joinBasename, removeDoubleSlashes };

package/dist/router/record-from-location.d.ts

@@ -13,6 +13,6 @@ export interface RecordFromLocationOptions {
 /**
  * The record at `state[stateSource]` if it is an object, else the JSON in the
  * `searchSource` param. Returns `null` for no param, invalid JSON, a repeated
- * param or a value that is not a plain object. Never throws.
+ * param or a value that is not an object. Never throws.
  */
 export declare function getRecordFromLocation(location: Pick<CheloneLocation, "state" | "searchParams">, options?: RecordFromLocationOptions): Record<string, unknown> | null;

package/dist/router/record-from-location.js

@@ -1,19 +1,27 @@
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
+import { isRecord } from "../guards.js";
+// src/router/record-from-location.ts
+/**
+* Read a seed record out of a location: the framework-free twin of ra-core's
+* `useRecordFromLocation`. A router adapter passes its `CheloneLocation`;
+* the clone link writes `?source=<json>`.
+*/
+/**
+* The record at `state[stateSource]` if it is an object, else the JSON in the
+* `searchSource` param. Returns `null` for no param, invalid JSON, a repeated
+* param or a value that is not an object. Never throws.
+*/
 function getRecordFromLocation(location, options = {}) {
-  const { searchSource = "source", stateSource = "record" } = options;
-  const fromState = isPlainObject(location.state) ? location.state[stateSource] : void 0;
-  if (isPlainObject(fromState)) return fromState;
-  const values = location.searchParams.getAll(searchSource);
-  if (values.length !== 1) return null;
-  try {
-    const parsed = JSON.parse(values[0]);
-    return isPlainObject(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
+	const { searchSource = "source", stateSource = "record" } = options;
+	const fromState = isRecord(location.state) ? location.state[stateSource] : void 0;
+	if (isRecord(fromState)) return fromState;
+	const values = location.searchParams.getAll(searchSource);
+	const [value] = values;
+	if (values.length !== 1 || value === void 0) return null;
+	try {
+		const parsed = JSON.parse(value);
+		return isRecord(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
 }
-export {
-  getRecordFromLocation
-};
+export { getRecordFromLocation };

package/dist/store/adapters.js

@@ -1,61 +1,57 @@
+// src/store/adapters.ts
 function memoryStoreAdapter(initial = {}) {
-  const map = new Map(Object.entries(initial));
-  return {
-    getItem: (key) => map.get(key),
-    setItem: (key, value) => void map.set(key, value),
-    removeItem: (key) => void map.delete(key)
-  };
+	const map = new Map(Object.entries(initial));
+	return {
+		getItem: (key) => map.get(key),
+		setItem: (key, value) => void map.set(key, value),
+		removeItem: (key) => void map.delete(key)
+	};
 }
+/** window/localStorage touched ONLY inside method bodies — module import is SSR-safe. */
 function storage() {
-  if (typeof window === "undefined") return void 0;
-  try {
-    return window.localStorage;
-  } catch {
-    return void 0;
-  }
+	if (typeof window === "undefined") return void 0;
+	try {
+		return window.localStorage;
+	} catch {
+		return;
+	}
 }
 function localStorageAdapter(options = {}) {
-  const prefix = options.prefix ?? "chelone.";
-  return {
-    getItem(key) {
-      const raw = storage()?.getItem(prefix + key);
-      if (raw == null) return void 0;
-      try {
-        return JSON.parse(raw);
-      } catch {
-        return void 0;
-      }
-    },
-    setItem(key, value) {
-      try {
-        storage()?.setItem(prefix + key, JSON.stringify(value));
-      } catch {
-      }
-    },
-    removeItem(key) {
-      storage()?.removeItem(prefix + key);
-    },
-    subscribeExternal(onChange) {
-      if (typeof window === "undefined") return () => {
-      };
-      const listener = (event) => {
-        if (!event.key?.startsWith(prefix)) return;
-        const key = event.key.slice(prefix.length);
-        if (event.newValue == null) {
-          onChange(key, void 0);
-          return;
-        }
-        try {
-          onChange(key, JSON.parse(event.newValue));
-        } catch {
-        }
-      };
-      window.addEventListener("storage", listener);
-      return () => window.removeEventListener("storage", listener);
-    }
-  };
+	const prefix = options.prefix ?? "chelone.";
+	return {
+		getItem(key) {
+			const raw = storage()?.getItem(prefix + key);
+			if (raw == null) return void 0;
+			try {
+				return JSON.parse(raw);
+			} catch {
+				return;
+			}
+		},
+		setItem(key, value) {
+			try {
+				storage()?.setItem(prefix + key, JSON.stringify(value));
+			} catch {}
+		},
+		removeItem(key) {
+			storage()?.removeItem(prefix + key);
+		},
+		subscribeExternal(onChange) {
+			if (typeof window === "undefined") return () => {};
+			const listener = (event) => {
+				if (!event.key?.startsWith(prefix)) return;
+				const key = event.key.slice(prefix.length);
+				if (event.newValue == null) {
+					onChange(key, void 0);
+					return;
+				}
+				try {
+					onChange(key, JSON.parse(event.newValue));
+				} catch {}
+			};
+			window.addEventListener("storage", listener);
+			return () => window.removeEventListener("storage", listener);
+		}
+	};
 }
-export {
-  localStorageAdapter,
-  memoryStoreAdapter
-};
+export { localStorageAdapter, memoryStoreAdapter };

package/dist/store/micro-store.js

@@ -1,61 +1,59 @@
+// src/store/micro-store.ts
 function createMicroStore(initial, options) {
-  let state = initial;
-  let destroyed = false;
-  let attachTeardown;
-  const subscriptions = /* @__PURE__ */ new Set();
-  const cleanups = /* @__PURE__ */ new Set();
-  const detach = () => {
-    const teardown = attachTeardown;
-    attachTeardown = void 0;
-    teardown?.();
-  };
-  return {
-    getSnapshot: () => state,
-    setState(update) {
-      if (destroyed) return;
-      const patch = typeof update === "function" ? update(state) : update;
-      let changed = false;
-      for (const [key, value] of Object.entries(patch)) {
-        if (!Object.is(state[key], value)) {
-          changed = true;
-          break;
-        }
-      }
-      if (!changed) return;
-      state = { ...state, ...patch };
-      for (const subscription of subscriptions) subscription.callback();
-    },
-    subscribe(callback) {
-      if (destroyed) return () => {
-      };
-      const subscription = { callback };
-      const isFirst = subscriptions.size === 0;
-      subscriptions.add(subscription);
-      if (isFirst && options?.onSubscribed) {
-        attachTeardown = options.onSubscribed() ?? void 0;
-      }
-      return () => {
-        if (!subscriptions.delete(subscription)) return;
-        if (subscriptions.size === 0 && !destroyed) detach();
-      };
-    },
-    destroy() {
-      if (destroyed) return;
-      destroyed = true;
-      detach();
-      for (const cleanup of cleanups) cleanup();
-      cleanups.clear();
-      subscriptions.clear();
-    },
-    onDestroy(cleanup) {
-      if (destroyed) {
-        cleanup();
-        return;
-      }
-      cleanups.add(cleanup);
-    }
-  };
+	let state = initial;
+	let destroyed = false;
+	let attachTeardown;
+	const subscriptions = /* @__PURE__ */ new Set();
+	const cleanups = /* @__PURE__ */ new Set();
+	/** Runs the attach teardown at most once per attach cycle. */
+	const detach = () => {
+		const teardown = attachTeardown;
+		attachTeardown = void 0;
+		teardown?.();
+	};
+	return {
+		getSnapshot: () => state,
+		setState(update) {
+			if (destroyed) return;
+			const patch = typeof update === "function" ? update(state) : update;
+			let changed = false;
+			for (const key in patch) if (!Object.is(state[key], patch[key])) {
+				changed = true;
+				break;
+			}
+			if (!changed) return;
+			state = {
+				...state,
+				...patch
+			};
+			for (const subscription of subscriptions) subscription.callback();
+		},
+		subscribe(callback) {
+			if (destroyed) return () => {};
+			const subscription = { callback };
+			const isFirst = subscriptions.size === 0;
+			subscriptions.add(subscription);
+			if (isFirst && options?.onSubscribed) attachTeardown = options.onSubscribed() ?? void 0;
+			return () => {
+				if (!subscriptions.delete(subscription)) return;
+				if (subscriptions.size === 0 && !destroyed) detach();
+			};
+		},
+		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			detach();
+			for (const cleanup of cleanups) cleanup();
+			cleanups.clear();
+			subscriptions.clear();
+		},
+		onDestroy(cleanup) {
+			if (destroyed) {
+				cleanup();
+				return;
+			}
+			cleanups.add(cleanup);
+		}
+	};
 }
-export {
-  createMicroStore
-};
+export { createMicroStore };

package/dist/store/shallow-equal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `shallowEqual(a, b)`: shallow equality with `Object.is` semantics at the top
+ * level. Parity with ra-core's `shallowEqual`.
+ *
+ * - `Object.is`-equal inputs are equal, so `NaN` equals `NaN` and `0` differs
+ *   from `-0`;
+ * - two objects or arrays are equal iff they have the same own enumerable keys
+ *   and each value pair is `Object.is`-equal; nested values compare by
+ *   reference;
+ * - a non-object, or `null`, that is not `Object.is`-equal is unequal.
+ */
+export declare function shallowEqual(a: unknown, b: unknown): boolean;

package/dist/store/shallow-equal.js

@@ -0,0 +1,20 @@
+// src/store/shallow-equal.ts
+/**
+* `shallowEqual(a, b)`: shallow equality with `Object.is` semantics at the top
+* level. Parity with ra-core's `shallowEqual`.
+*
+* - `Object.is`-equal inputs are equal, so `NaN` equals `NaN` and `0` differs
+*   from `-0`;
+* - two objects or arrays are equal iff they have the same own enumerable keys
+*   and each value pair is `Object.is`-equal; nested values compare by
+*   reference;
+* - a non-object, or `null`, that is not `Object.is`-equal is unequal.
+*/
+function shallowEqual(a, b) {
+	if (Object.is(a, b)) return true;
+	if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) return false;
+	const keysA = Object.keys(a);
+	if (keysA.length !== Object.keys(b).length) return false;
+	return keysA.every((key) => Object.hasOwn(b, key) && Object.is(Reflect.get(a, key), Reflect.get(b, key)));
+}
+export { shallowEqual };

package/dist/store/store.js

@@ -1,59 +1,56 @@
+// src/store/store.ts
 function createStore(adapter) {
-  const cache = /* @__PURE__ */ new Map();
-  const hydrated = /* @__PURE__ */ new Set();
-  const subscribers = /* @__PURE__ */ new Map();
-  const notify = (key) => {
-    const set = subscribers.get(key);
-    if (set) for (const cb of set) cb();
-  };
-  const apply = (key, value) => {
-    hydrated.add(key);
-    if (value === void 0) cache.delete(key);
-    else cache.set(key, value);
-    notify(key);
-  };
-  adapter?.subscribeExternal?.((key, value) => apply(key, value));
-  return {
-    getItem(key) {
-      if (!hydrated.has(key) && adapter) {
-        hydrated.add(key);
-        const persisted = adapter.getItem(key);
-        if (persisted !== void 0) cache.set(key, persisted);
-      }
-      return cache.get(key);
-    },
-    setItem(key, value) {
-      hydrated.add(key);
-      if (Object.is(cache.get(key), value)) return;
-      cache.set(key, value);
-      adapter?.setItem(key, value);
-      notify(key);
-    },
-    removeItem(key) {
-      hydrated.add(key);
-      cache.delete(key);
-      adapter?.removeItem(key);
-      notify(key);
-    },
-    subscribe(key, callback) {
-      let set = subscribers.get(key);
-      if (!set) {
-        set = /* @__PURE__ */ new Set();
-        subscribers.set(key, set);
-      }
-      set.add(callback);
-      return () => {
-        set.delete(callback);
-        if (set.size === 0 && subscribers.get(key) === set) {
-          subscribers.delete(key);
-        }
-      };
-    },
-    keys() {
-      return [...cache.keys()];
-    }
-  };
+	const cache = /* @__PURE__ */ new Map();
+	const hydrated = /* @__PURE__ */ new Set();
+	const subscribers = /* @__PURE__ */ new Map();
+	const notify = (key) => {
+		const set = subscribers.get(key);
+		if (set) for (const cb of set) cb();
+	};
+	const apply = (key, value) => {
+		hydrated.add(key);
+		if (value === void 0) cache.delete(key);
+		else cache.set(key, value);
+		notify(key);
+	};
+	adapter?.subscribeExternal?.((key, value) => apply(key, value));
+	return {
+		getItem(key) {
+			if (!hydrated.has(key) && adapter) {
+				hydrated.add(key);
+				const persisted = adapter.getItem(key);
+				if (persisted !== void 0) cache.set(key, persisted);
+			}
+			return cache.get(key);
+		},
+		setItem(key, value) {
+			hydrated.add(key);
+			if (Object.is(cache.get(key), value)) return;
+			cache.set(key, value);
+			adapter?.setItem(key, value);
+			notify(key);
+		},
+		removeItem(key) {
+			hydrated.add(key);
+			cache.delete(key);
+			adapter?.removeItem(key);
+			notify(key);
+		},
+		subscribe(key, callback) {
+			let set = subscribers.get(key);
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				subscribers.set(key, set);
+			}
+			set.add(callback);
+			return () => {
+				set.delete(callback);
+				if (set.size === 0 && subscribers.get(key) === set) subscribers.delete(key);
+			};
+		},
+		keys() {
+			return [...cache.keys()];
+		}
+	};
 }
-export {
-  createStore
-};
+export { createStore };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,21 +30,23 @@
     "zod": "^3.25.0 || ^4.0.0"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.0",
-    "@tanstack/form-core": "^1.33.0",
-    "@tanstack/query-core": "^5.0.0",
-    "@types/node": "^22.20.0",
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@chelone/test-utils": "0.0.0",
+    "@tanstack/form-core": "^1.33.5",
+    "@tanstack/query-core": "^5.106.1",
+    "@types/node": "^26.6.6",
     "@types/papaparse": "^5.5.2",
-    "jsdom": "^26.1.0",
+    "jsdom": "^31.0.0",
     "papaparse": "^5.7.0",
-    "publint": "^0.3.0",
+    "publint": "^0.3.25",
     "terra-draw": "^1.39.0",
-    "vite": "^7.0.0",
-    "vitest": "^3.0.0",
-    "zod": "^3.25.0"
+    "vite": "^8.3.6",
+    "vitest": "^5.1.0",
+    "zod": "^4.6.7"
   },
   "dependencies": {
-    "dot.paths": "^0.2.1"
+    "@types/geojson": "^7946.0.16",
+    "dot.paths": "^0.2.2"
   },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/dts-extensions.mjs dist",