@twinsearth/fang-dsh-plugin 0.0.0-stage → 3.3.4

package/src/kernel/types.mjs

@@ -0,0 +1,266 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Fang contributors — see LICENSE-CORE.
+// dsh-Fang kernel — the shared vocabulary of the 1 orchestrator + 9 sub-plugins.
+// Kept as plain constants so plugin code, tests and the client half agree on names.
+
+/** Host service keys. Every sub-plugin provides exactly one; subplugins read peers through `ctx.get`. */
+export const SERVICE = {
+  orchestrator: 'fang',
+  forker: 'fangForker',
+  scorer: 'fangScorer',
+  healer: 'fangHealer',
+  approver: 'fangApprover',
+  hotReloader: 'fangHotReloader',
+  restart: 'fangRestart',
+  buffer: 'fangBuffer',
+  auditor: 'fangAudit',
+  router: 'fangRouter',
+  umbrella: 'fangUmbrella',
+  adapter: 'fangAdapter',
+  commercial: 'fangCommercial',
+  sessionCatalog: 'fangSessionCatalog',
+  sessionBridge: 'fangSessionBridge',
+  sessionSync: 'fangSessionSync',
+  sessionRouter: 'fangSessionRouter',
+  link: 'fangLink',
+  mirror: 'fangMirror',
+  decisionCenter: 'fangDecisionCenter',
+  contract: 'fangContract',
+  queueJournal: 'fangQueueJournal',
+}
+
+/** Loader row ids used by cordis.patch.yml. */
+export const ROW = {
+  orchestrator: 'fang-orchestrator',
+  forker: 'fang-forker',
+  scorer: 'fang-scorer',
+  healer: 'fang-healer',
+  approver: 'fang-approver',
+  hotReloader: 'fang-hot-reloader',
+  restart: 'fang-restart-guard',
+  buffer: 'fang-buffer-keeper',
+  auditor: 'fang-auditor',
+  router: 'fang-router',
+  umbrella: 'fang-umbrella',
+  sessionCatalog: 'fang-session-catalog',
+  sessionBridge: 'fang-session-bridge',
+  sessionSync: 'fang-session-sync',
+  sessionRouter: 'fang-session-router',
+  decisionCenter: 'fang-decision-center',
+  queueJournal: 'fang-queue-journal',
+}
+
+export const FORK_STATUS = {
+  PROVISIONING: 'provisioning',
+  RUNNING: 'running',
+  CRASHED: 'crashed',
+  STOPPED: 'stopped',
+  REAPED: 'reaped',
+}
+
+/** Risk vocabulary shared by scorer / approver / restart-guard. */
+export const RISK = { BLUE: 'blue', YELLOW: 'yellow', RED: 'red' }
+
+/**
+ * Action light vocabulary (v2.7.6, `fang-umbrella`).
+ *
+ * `RISK` above is the *approval* enum of restart-guard (three levels, no "nothing to
+ * approve"). The umbrella light is four levels because it also has to say "no side
+ * effect at all" — green. Mapping: green → auto-allow, blue → auto-allow + mark,
+ * yellow → ask, red → ask(critical)/deny/delegate.
+ */
+export const LIGHT = { GREEN: 'green', BLUE: 'blue', YELLOW: 'yellow', RED: 'red' }
+
+/** Light severity order; higher rank == more dangerous. */
+export const LIGHT_RANK = { green: 1, blue: 2, yellow: 3, red: 4 }
+
+
+/** Static plugin grades (A safest .. E veto). */
+export const GRADE = ['A', 'B', 'C', 'D', 'E']
+
+export const GRADE_COLOR = { A: 'green', B: 'blue', C: 'yellow', D: 'red', E: 'red' }
+
+/** Router outcomes. */
+export const ROUTE = { SANDBOX: 'sandbox', CONTAINER: 'container', DENY: 'deny' }
+
+/** Restart-guard state machine (mother level only). */
+export const GUARD_STATE = {
+  IDLE: 'idle',
+  COLLECTING: 'collecting',
+  AWAITING: 'awaiting',
+  EXECUTING: 'executing',
+}
+
+/** Buffer watcher three-state judgement. */
+export const BUFFER_STATE = { SETTLED: 'settled', WRITING: 'writing', PENDING_HIGH_RISK: 'pending-high-risk' }
+
+/** Audit record kinds written by the auditor. */
+export const AUDIT = {
+  BOOT: 'boot',
+  BOOT_VERIFY: 'boot-verify',
+  FORK_CREATED: 'fork-created',
+  FORK_STARTED: 'fork-started',
+  FORK_CRASHED: 'fork-crashed',
+  FORK_SUPERVISION: 'fork-supervision',
+  FORK_REAPED: 'fork-reaped',
+  FORK_HEALTH: 'fork-health',
+  PROMOTE_REQUESTED: 'promote-requested',
+  PROMOTE_COMMITTED: 'promote-committed',
+  PROMOTE_FAILED: 'promote-failed',
+  RESTART_REQUESTED: 'restart-requested',
+  RESTART_RESOLVED: 'restart-resolved',
+  RESTART_DENIED: 'restart-denied',
+  SHUTDOWN_GRACEFUL: 'shutdown-graceful',
+  APPROVAL_REQUESTED: 'approval-requested',
+  APPROVAL_DECIDED: 'approval-decided',
+  SNapshot_CREATED: 'snapshot-created',
+  ROLLBACK: 'rollback',
+  ROUND_OPEN: 'round-open',
+  ROUND_RESET: 'round-reset',
+  SCORE: 'score',
+  UMBRELLA_DECISION: 'umbrella-decision',
+  UMBRELLA_STRICT_MODE: 'umbrella-strict-mode',
+  ROUTE: 'route',
+  BUFFER_FLUSH: 'buffer-flush',
+  TASK_READY: 'task-ready',
+  TASK_ARCHIVED: 'task-archived',
+  TASK_RESTORED: 'task-restored',
+  ADAPTER_HANDSHAKE: 'adapter-handshake',
+  ROUTE_CONFIRMED: 'route-confirmed',
+  LINK_PROBE: 'link-probe',
+  RUNTIME_ERROR: 'runtime-error',
+}
+
+export const FANG_VERSION = '3.3.4'
+
+/**
+ * @typedef {object} ForkInfo
+ * @property {string} forkId
+ * @property {string} taskTitle
+ * @property {'provisioning'|'running'|'crashed'|'stopped'|'reaped'} status
+ * @property {number|null} pid
+ * @property {number|null} port
+ * @property {string} homeDir
+ * @property {string} profile
+ * @property {string|null} url
+ * @property {number} createdAt
+ * @property {number} restarts
+ * @property {object|null} health
+ */
+
+/**
+ * @typedef {object} Assessment
+ * @property {'A'|'B'|'C'|'D'|'E'} grade
+ * @property {number} score
+ * @property {'green'|'blue'|'yellow'|'red'} color
+ * @property {boolean} veto
+ * @property {string[]} reasons
+ * @property {{id:string, weight:number}[]} signals
+ */
+
+/**
+ * @typedef {object} ImpactReport
+ * @property {string[]} activeForks
+ * @property {string[]} pendingPromotes
+ * @property {string[]} dirtyBuffers
+ * @property {number} activeSessions
+ */
+
+
+/** Task lifecycle (v2): a task is the product-facing unit, a fork is its process. */
+export const TASK_STATUS = {
+  PROVISIONING: 'provisioning',
+  READY: 'ready',
+  RUNNING: 'running',
+  ARCHIVED: 'archived',
+  FAILED: 'failed',
+}
+
+/** Adapter command vocabulary (mother → fork control channel). */
+export const ADAPTER_OP = {
+  PING: 'ping',
+  STATUS: 'status',
+  FLUSH_BUFFER: 'flush-buffer',
+  SCORE_PLUGIN: 'score-plugin',
+  READ_PLUGIN: 'read-plugin',
+  ROUTE_CONFIRM: 'route-confirm',
+  APPROVALS: 'approvals',
+  APPROVAL_DECIDE: 'approval-decide',
+  ARCHIVE: 'archive',
+  FORK_SESSION: 'fork-session',
+  DECISION_INGEST: 'decision-ingest',
+}
+
+/** Adapter HTTP route suffixes (fork side). */
+export const ADAPTER_ROUTE = {
+  HELLO: '/adapter/hello',
+  IDENTITY: '/adapter/identity',
+  CLIENT_REPORT: '/adapter/client-report',
+  STATUS: '/adapter/status',
+  APPROVALS: '/adapter/approvals',
+  AUDIT: '/adapter/audit',
+  COMMAND: '/adapter/command',
+  // ── v3（docs/PROTOCOL-V3.md §4）：与 v2 五条并存，向后兼容 ──
+  VERSION: '/adapter/version',
+  HEALTH: '/adapter/health',
+  STATE: '/adapter/state',
+  EVENTS: '/adapter/events',
+  COMMANDS: '/adapter/commands',
+}
+
+/**
+ * Adapter 协议版本（v2.6.1 起）。两侧编译期常量：母体用它做版本协商，分身
+ * 在 /adapter/version 与 /adapter/state 里回报。
+ */
+export const ADAPTER_PROTOCOL_VERSION = 3
+/** 母体可接受的最低协议版本（v1 = 无版本号的 v2.0 握手，按 legacy 处理）。 */
+export const ADAPTER_PROTOCOL_MIN = 1
+
+/** Adapter 事件种类（SSE 下行，docs/PROTOCOL-V3.md §6）。 */
+export const ADAPTER_EVENT = {
+  STATE_CHANGED: 'state-changed',
+  PLUGIN_STATE: 'plugin-state',
+  APPROVAL_REQUESTED: 'approval-requested',
+  APPROVAL_RESOLVED: 'approval-resolved',
+  AUDIT: 'audit',
+  COMMAND: 'command',
+  COMMAND_PROGRESS: 'command-progress',
+  COMMAND_DONE: 'command-done',
+  ERROR: 'error',
+}
+
+/**
+ * Adapter 错误码 → HTTP 状态码（docs/PROTOCOL-V3.md §8）。
+ * 未登记的 code 一律 500：宁可让母体看到一个明确的失败，也不要假装成功。
+ */
+export const ADAPTER_ERROR_STATUS = {
+  'bad-request': 400,
+  'invalid-json': 400,
+  'invalid-payload': 400,
+  'missing-op': 400,
+  'unknown-op': 400,
+  'path-escape': 400,
+  'file-too-large': 400,
+  'total-too-large': 400,
+  'binary-file': 400,
+  'body-too-large': 413,
+  'cursor-invalid': 400,
+  'command-id-invalid': 400,
+  unauthorized: 401,
+  'not-found': 404,
+  'plugin-not-found': 404,
+  'session-changed': 409,
+  'state-conflict': 409,
+  'not-pending': 409,
+  'service-unavailable': 409,
+  'not-configured': 409,
+  conflict: 409,
+  timeout: 409,
+  'cursor-expired': 410,
+  'handler-threw': 500,
+  'internal-error': 500,
+  'not-ready': 503,
+}
+
+/** Container (AppContainer) executor states. */
+export const CONTAINER = { DISABLED: 'disabled', UNAVAILABLE: 'unavailable', READY: 'ready' }

package/src/kernel/vendor/cosmokit.mjs

@@ -0,0 +1,421 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2022-present Shigma and cordis contributors (upstream: https://github.com/shigma/cordis)
+// Vendored into dsh-Fang; see LICENSES/cordis-MIT.txt.
+//#region lib/types/misc.js
+/** No-op callback returning `undefined` at runtime and `any` at type level. */
+function noop() {}
+/** Return true when a value is `null` or `undefined`. */
+function isNullable(value) {
+	return value === null || value === void 0;
+}
+/** Return true when a value is neither `null` nor `undefined`. */
+function isNonNullable(value) {
+	return !isNullable(value);
+}
+/** Return true for non-array object values. */
+function isPlainObject(data) {
+	return data && typeof data === "object" && !Array.isArray(data);
+}
+/** Filter object entries and return a new object. */
+function filterKeys(object, filter) {
+	return Object.fromEntries(Object.entries(object).filter(([key, value]) => filter(key, value)));
+}
+/** Map object values while preserving the original key set. */
+function mapValues(object, transform) {
+	return Object.fromEntries(Object.entries(object).map(([key, value]) => [key, transform(value, key)]));
+}
+/** Pick selected keys from an object, optionally including `undefined` values. */
+function pick(source, keys, forced) {
+	if (!keys) return { ...source };
+	const result = {};
+	for (const key of keys) if (forced || source[key] !== void 0) result[key] = source[key];
+	return result;
+}
+/** Omit selected keys from a shallow object copy. */
+function omit(source, keys) {
+	if (!keys) return { ...source };
+	const result = { ...source };
+	for (const key of keys) Reflect.deleteProperty(result, key);
+	return result;
+}
+/** Define a non-enumerable writable property and return the object. */
+function defineProperty(object, key, value) {
+	return Object.defineProperty(object, key, {
+		writable: true,
+		value,
+		enumerable: false
+	});
+}
+//#endregion
+//#region lib/types/array.js
+/** Return true when every item in `array2` is present in `array1`. */
+function contain(array1, array2) {
+	return array2.every((item) => array1.includes(item));
+}
+/** Return items that appear in both arrays. */
+function intersection(array1, array2) {
+	return array1.filter((item) => array2.includes(item));
+}
+/** Return items from `array1` that do not appear in `array2`. */
+function difference(array1, array2) {
+	return array1.filter((item) => !array2.includes(item));
+}
+/** Return the set-union of two arrays while preserving first occurrence order. */
+function union(array1, array2) {
+	return Array.from(new Set([...array1, ...array2]));
+}
+/** Remove duplicate values while preserving first occurrence order. */
+function deduplicate(array) {
+	return [...new Set(array)];
+}
+/** Remove one item from an array and report whether it was found. */
+function remove(list, item) {
+	const index = list?.indexOf(item);
+	if (index >= 0) {
+		list.splice(index, 1);
+		return true;
+	} else return false;
+}
+/** Normalize nullish, scalar, or array input to an array. */
+function makeArray(source) {
+	return Array.isArray(source) ? source : isNullable(source) ? [] : [source];
+}
+//#endregion
+//#region lib/types/volatile.js
+/** Shared config references used by schema validators and plugin runtimes. */
+const write = Symbol.for("cosmokit.volatile.write");
+function snapshot(value, ancestors = /* @__PURE__ */ new Set()) {
+	if (typeof value === "function") throw new TypeError("volatile config cannot contain functions");
+	if (value === null || typeof value !== "object") return value;
+	if (ancestors.has(value)) throw new TypeError("volatile config cannot contain cycles");
+	ancestors.add(value);
+	try {
+		if (Array.isArray(value)) return Object.freeze(value.map((item) => snapshot(item, ancestors)));
+		if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) throw new TypeError("volatile config objects must be plain objects or arrays");
+		return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, item]) => [key, snapshot(item, ancestors)])));
+	} finally {
+		ancestors.delete(value);
+	}
+}
+/**
+* Create a detached reference containing an immutable copy of the supplied data.
+* @param value - validated config data; class instances and functions are unsupported.
+* @returns a reference whose value is updated only by its owning runtime.
+*/
+function createVolatile(value) {
+	let current = snapshot(value);
+	return Object.freeze({
+		get: () => current,
+		[write]: (value) => {
+			current = value;
+		}
+	});
+}
+/**
+* Identify references across ESM/CJS copies of the shared library.
+* @param value - a parsed config value.
+* @returns whether the value implements the shared reference protocol.
+*/
+function isVolatile(value) {
+	return typeof value === "object" && value !== null && write in value;
+}
+/**
+* Collect config references without descending into their snapshots or opaque objects.
+* @internal
+* @param value - parsed config; cyclic ordinary fields are visited once per path.
+* @returns references and their object-key paths, including an empty path for a root reference.
+*/
+function volatileEntries(value) {
+	const ancestors = /* @__PURE__ */ new Set();
+	function visit(value, path) {
+		if (isVolatile(value)) return [{
+			path,
+			ref: value
+		}];
+		if (!value || typeof value !== "object" || ancestors.has(value)) return [];
+		if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) return [];
+		ancestors.add(value);
+		try {
+			return Object.entries(value).flatMap(([key, child]) => visit(child, [...path, key]));
+		} finally {
+			ancestors.delete(value);
+		}
+	}
+	return visit(value, []);
+}
+/**
+* Commit an already validated immutable snapshot from another reference.
+* @internal
+* @param target - the owning plugin's stable reference.
+* @param source - a newly parsed candidate reference.
+*/
+function updateVolatile(target, source) {
+	target[write](source.get());
+}
+//#endregion
+//#region lib/types/types.js
+/** Test values using `instanceof` with a `toStringTag` fallback. */
+function is(type, value) {
+	if (arguments.length === 1) return (value) => is(type, value);
+	return type in globalThis && value instanceof globalThis[type] || Object.prototype.toString.call(value).slice(8, -1) === type;
+}
+function isArrayBufferLike(value) {
+	return is("ArrayBuffer", value) || is("SharedArrayBuffer", value);
+}
+function isArrayBufferSource(value) {
+	return isArrayBufferLike(value) || ArrayBuffer.isView(value);
+}
+/** Binary source detection and base64/hex conversion helpers. */
+var Binary;
+(function(Binary) {
+	Binary.is = isArrayBufferLike;
+	Binary.isSource = isArrayBufferSource;
+	function fromSource(source) {
+		if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+		else return source;
+	}
+	Binary.fromSource = fromSource;
+	function toBase64(source) {
+		source = fromSource(source);
+		if (typeof Buffer !== "undefined") return Buffer.from(source).toString("base64");
+		let binary = "";
+		const bytes = new Uint8Array(source);
+		for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
+		return btoa(binary);
+	}
+	Binary.toBase64 = toBase64;
+	function fromBase64(source) {
+		if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "base64"));
+		return Uint8Array.from(atob(source), (c) => c.charCodeAt(0));
+	}
+	Binary.fromBase64 = fromBase64;
+	function toHex(source) {
+		source = fromSource(source);
+		if (typeof Buffer !== "undefined") return Buffer.from(source).toString("hex");
+		return Array.from(new Uint8Array(source), (byte) => byte.toString(16).padStart(2, "0")).join("");
+	}
+	Binary.toHex = toHex;
+	function fromHex(source) {
+		if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "hex"));
+		const hex = source.length % 2 === 0 ? source : source.slice(0, source.length - 1);
+		const buffer = [];
+		for (let i = 0; i < hex.length; i += 2) buffer.push(parseInt(`${hex[i]}${hex[i + 1]}`, 16));
+		return Uint8Array.from(buffer).buffer;
+	}
+	Binary.fromHex = fromHex;
+})(Binary || (Binary = {}));
+/** Decode a base64 string into binary data. */
+const base64ToArrayBuffer = Binary.fromBase64;
+/** Encode binary data as base64. */
+const arrayBufferToBase64 = Binary.toBase64;
+/** Decode a hex string into binary data. */
+const hexToArrayBuffer = Binary.fromHex;
+/** Encode binary data as hex. */
+const arrayBufferToHex = Binary.toHex;
+/** Deep-clone common JavaScript values while preserving prototypes and cycles. */
+function clone(source, refs = /* @__PURE__ */ new Map()) {
+	if (!source || typeof source !== "object") return source;
+	if (is("Date", source)) return new Date(source.valueOf());
+	if (is("RegExp", source)) return new RegExp(source.source, source.flags);
+	if (isArrayBufferLike(source)) return source.slice(0);
+	if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+	const cached = refs.get(source);
+	if (cached) return cached;
+	if (Array.isArray(source)) {
+		const result = [];
+		refs.set(source, result);
+		source.forEach((value, index) => {
+			result[index] = Reflect.apply(clone, null, [value, refs]);
+		});
+		return result;
+	}
+	const result = Object.create(Object.getPrototypeOf(source));
+	refs.set(source, result);
+	for (const key of Reflect.ownKeys(source)) {
+		const descriptor = { ...Reflect.getOwnPropertyDescriptor(source, key) };
+		if ("value" in descriptor) descriptor.value = Reflect.apply(clone, null, [descriptor.value, refs]);
+		Reflect.defineProperty(result, key, descriptor);
+	}
+	return result;
+}
+/**
+* Compare values recursively, treating two volatile references as equal regardless of value.
+* Strict comparison distinguishes null/undefined, treats opaque objects by identity,
+* compares URLs by normalized href, treats array holes as undefined, and considers distinct cyclic structures unequal.
+* @param a - first value.
+* @param b - second value.
+* @param strict - whether to require strict data equality outside volatile references.
+* @returns whether the values compare equal.
+*/
+function deepEqual(a, b, strict) {
+	const ancestors = /* @__PURE__ */ new Set();
+	function compare(a, b) {
+		if (a === b) return true;
+		if (isVolatile(a) || isVolatile(b)) return isVolatile(a) && isVolatile(b);
+		if (!strict && isNullable(a) && isNullable(b)) return true;
+		if (typeof a !== typeof b || typeof a !== "object" || !a || !b) return false;
+		if (ancestors.has(a)) return false;
+		function check(test, then) {
+			return test(a) ? test(b) ? then(a, b) : false : test(b) ? false : void 0;
+		}
+		ancestors.add(a);
+		try {
+			return check(Array.isArray, (a, b) => {
+				if (a.length !== b.length) return false;
+				for (let index = 0; index < a.length; index++) if (!compare(a[index], b[index])) return false;
+				return true;
+			}) ?? check(is("Date"), (a, b) => a.valueOf() === b.valueOf()) ?? check(is("URL"), (a, b) => a.href === b.href) ?? check(is("RegExp"), (a, b) => a.source === b.source && a.flags === b.flags) ?? check(isArrayBufferLike, (a, b) => {
+				if (a.byteLength !== b.byteLength) return false;
+				const viewA = new Uint8Array(a);
+				const viewB = new Uint8Array(b);
+				for (let i = 0; i < viewA.length; i++) if (viewA[i] !== viewB[i]) return false;
+				return true;
+			}) ?? ((!strict || [a, b].every((value) => Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)) && Object.keys({
+				...a,
+				...b
+			}).every((key) => compare(a[key], b[key])));
+		} finally {
+			ancestors.delete(a);
+		}
+	}
+	return compare(a, b);
+}
+//#endregion
+//#region lib/types/string.js
+/** Uppercase the first character of a string. */
+function capitalize(source) {
+	return source.charAt(0).toUpperCase() + source.slice(1);
+}
+/** Lowercase the first character of a string. */
+function uncapitalize(source) {
+	return source.charAt(0).toLowerCase() + source.slice(1);
+}
+/** Convert dash or underscore delimited text to camelCase. */
+function camelCase(source) {
+	return source.replace(/[_-][a-z]/g, (str) => str.slice(1).toUpperCase());
+}
+function tokenize(source, delimiters, delimiter) {
+	const output = [];
+	let state = 0;
+	for (let i = 0; i < source.length; i++) {
+		const code = source.charCodeAt(i);
+		if (code >= 65 && code <= 90) {
+			if (state === 1) {
+				const next = source.charCodeAt(i + 1);
+				if (next >= 97 && next <= 122) output.push(delimiter);
+				output.push(code + 32);
+			} else {
+				if (state !== 0) output.push(delimiter);
+				output.push(code + 32);
+			}
+			state = 1;
+		} else if (code >= 97 && code <= 122) {
+			output.push(code);
+			state = 2;
+		} else if (delimiters.includes(code)) {
+			if (state !== 0) output.push(delimiter);
+			state = 0;
+		} else output.push(code);
+	}
+	return String.fromCharCode(...output);
+}
+/** Convert text to dash-delimited parameter case. */
+function paramCase(source) {
+	return tokenize(source, [45, 95], 45);
+}
+/** Convert text to underscore-delimited snake case. */
+function snakeCase(source) {
+	return tokenize(source, [45, 95], 95);
+}
+/** Runtime alias for `camelCase`. */
+const camelize = camelCase;
+/** Runtime alias for `paramCase`. */
+const hyphenate = paramCase;
+/** Format a property key as a JavaScript member access suffix. */
+function formatProperty(key) {
+	if (typeof key !== "string") return `[${key.toString()}]`;
+	return /^[a-z_$][\w$]*$/i.test(key) ? `.${key}` : `[${JSON.stringify(key)}]`;
+}
+/** Remove one trailing slash from a path string. */
+function trimSlash(source) {
+	return source.replace(/\/$/, "");
+}
+/** Ensure a path starts with `/` and has no trailing slash. */
+function sanitize(source) {
+	if (!source.startsWith("/")) source = "/" + source;
+	return trimSlash(source);
+}
+//#endregion
+//#region lib/types/time.js
+/** Time constants plus parsing and formatting helpers. */
+var Time;
+(function(Time) {
+	Time.millisecond = 1;
+	Time.second = 1e3;
+	Time.minute = Time.second * 60;
+	Time.hour = Time.minute * 60;
+	Time.day = Time.hour * 24;
+	Time.week = Time.day * 7;
+	let timezoneOffset = (/* @__PURE__ */ new Date()).getTimezoneOffset();
+	function setTimezoneOffset(offset) {
+		timezoneOffset = offset;
+	}
+	Time.setTimezoneOffset = setTimezoneOffset;
+	function getTimezoneOffset() {
+		return timezoneOffset;
+	}
+	Time.getTimezoneOffset = getTimezoneOffset;
+	function getDateNumber(date = /* @__PURE__ */ new Date(), offset) {
+		if (typeof date === "number") date = new Date(date);
+		if (offset === void 0) offset = timezoneOffset;
+		return Math.floor((date.valueOf() / Time.minute - offset) / 1440);
+	}
+	Time.getDateNumber = getDateNumber;
+	function fromDateNumber(value, offset) {
+		const date = new Date(value * Time.day);
+		if (offset === void 0) offset = timezoneOffset;
+		return new Date(+date + offset * Time.minute);
+	}
+	Time.fromDateNumber = fromDateNumber;
+	const numeric = /\d+(?:\.\d+)?/.source;
+	const timeRegExp = new RegExp(`^${[
+		"w(?:eek(?:s)?)?",
+		"d(?:ay(?:s)?)?",
+		"h(?:our(?:s)?)?",
+		"m(?:in(?:ute)?(?:s)?)?",
+		"s(?:ec(?:ond)?(?:s)?)?"
+	].map((unit) => `(${numeric}${unit})?`).join("")}$`);
+	function parseTime(source) {
+		const capture = timeRegExp.exec(source);
+		if (!capture) return 0;
+		return (parseFloat(capture[1]) * Time.week || 0) + (parseFloat(capture[2]) * Time.day || 0) + (parseFloat(capture[3]) * Time.hour || 0) + (parseFloat(capture[4]) * Time.minute || 0) + (parseFloat(capture[5]) * Time.second || 0);
+	}
+	Time.parseTime = parseTime;
+	function parseDate(date) {
+		const parsed = parseTime(date);
+		if (parsed) date = Date.now() + parsed;
+		else if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).toLocaleDateString()}-${date}`;
+		else if (/^\d{1,2}-\d{1,2}-\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).getFullYear()}-${date}`;
+		return date ? new Date(date) : /* @__PURE__ */ new Date();
+	}
+	Time.parseDate = parseDate;
+	function format(ms) {
+		const abs = Math.abs(ms);
+		if (abs >= Time.day - Time.hour / 2) return Math.round(ms / Time.day) + "d";
+		else if (abs >= Time.hour - Time.minute / 2) return Math.round(ms / Time.hour) + "h";
+		else if (abs >= Time.minute - Time.second / 2) return Math.round(ms / Time.minute) + "m";
+		else if (abs >= Time.second) return Math.round(ms / Time.second) + "s";
+		return ms + "ms";
+	}
+	Time.format = format;
+	function toDigits(source, length = 2) {
+		return source.toString().padStart(length, "0");
+	}
+	Time.toDigits = toDigits;
+	function template(template, time = /* @__PURE__ */ new Date()) {
+		return template.replace("yyyy", time.getFullYear().toString()).replace("yy", time.getFullYear().toString().slice(2)).replace("MM", toDigits(time.getMonth() + 1)).replace("dd", toDigits(time.getDate())).replace("hh", toDigits(time.getHours())).replace("mm", toDigits(time.getMinutes())).replace("ss", toDigits(time.getSeconds())).replace("SSS", toDigits(time.getMilliseconds(), 3));
+	}
+	Time.template = template;
+})(Time || (Time = {}));
+//#endregion
+export { Binary, Time, arrayBufferToBase64, arrayBufferToHex, base64ToArrayBuffer, camelCase, camelize, capitalize, clone, contain, createVolatile, deduplicate, deepEqual, defineProperty, difference, filterKeys, formatProperty, hexToArrayBuffer, hyphenate, intersection, is, isNonNullable, isNullable, isPlainObject, isVolatile, makeArray, mapValues, mapValues as valueMap, noop, omit, paramCase, pick, remove, sanitize, snakeCase, trimSlash, uncapitalize, union, updateVolatile, volatileEntries };