@uifn/core 0.0.1

package/dist/chunk-HTTKRX7S.mjs

@@ -0,0 +1,139 @@
+// src/errors.ts
+var CANONICAL_UIFN_ERROR_CODES = [
+  "UIFN_ERR_A11Y_GATE_FAILURE",
+  "UIFN_ERR_CONTEXT_MISSING",
+  "UIFN_ERR_CONTROLLED_STATE_DIVERGENCE",
+  "UIFN_ERR_DETERMINISTIC_ID_MISMATCH",
+  "UIFN_ERR_DOCS_DRIFT",
+  "UIFN_ERR_DUPLICATE_PUBLIC_ID",
+  "UIFN_ERR_EXPORT_SURFACE_MISMATCH",
+  "UIFN_ERR_FILES_SCOPE_DRIFT",
+  "UIFN_ERR_HYDRATION_MISMATCH",
+  "UIFN_ERR_INVALID_VALUE",
+  "UIFN_ERR_MANUAL_EVIDENCE_INVALID",
+  "UIFN_ERR_MENU_NAVIGATION",
+  "UIFN_ERR_PACK_ARTIFACT_LEAK",
+  "UIFN_ERR_POSITIONING_OVERFLOW",
+  "UIFN_ERR_PUBLIC_SURFACE_DRIFT",
+  "UIFN_ERR_RANGE_OUT_OF_BOUNDS",
+  "UIFN_ERR_SCROLL_SYNC",
+  "UIFN_ERR_TEST_MATRIX_GAP",
+  "UIFN_ERR_TOOLCHAIN_MISCONFIG",
+  "UIFN_ERR_UNSUPPORTED_ENVIRONMENT",
+  "UIFN_ERR_UNSUPPORTED_PUBLIC_CLAIM",
+  "UIFN_ERR_WARNING_SUPPRESSED",
+  "UIFN_ERR_CONSUMER_SMOKE_FAILURE",
+  "UIFN_ERR_DIALOG_MODAL_INCOMPLETE"
+];
+var LEGACY_UIFN_ERROR_CODES = [
+  "UIFN_ERR_ASCHILD_CONTRACT",
+  "UIFN_ERR_COMBOBOX_FILTER_STATE",
+  "UIFN_ERR_DISABLED_INTERACTION",
+  "UIFN_ERR_SVELTE_REACTIVITY_SNAPSHOT"
+];
+var UIFN_ERROR_CODES = [
+  ...CANONICAL_UIFN_ERROR_CODES,
+  ...LEGACY_UIFN_ERROR_CODES
+];
+var DEFAULT_MESSAGES = {
+  UIFN_ERR_CONTEXT_MISSING: "Required UI context is missing.",
+  UIFN_ERR_DETERMINISTIC_ID_MISMATCH: "Public IDs MUST be deterministic across runtimes.",
+  UIFN_ERR_DUPLICATE_PUBLIC_ID: "GA surfaces MUST NOT share fixed instance-scoped IDs.",
+  UIFN_ERR_INVALID_VALUE: "Invalid public value for this surface.",
+  UIFN_ERR_RANGE_OUT_OF_BOUNDS: "Public value is outside the supported range.",
+  UIFN_ERR_TOOLCHAIN_MISCONFIG: "Verification failed due to toolchain misconfiguration.",
+  UIFN_ERR_UNSUPPORTED_ENVIRONMENT: "Unsupported environment matrix for this package."
+};
+var UIFnError = class extends Error {
+  constructor(options) {
+    const message = options.message ?? DEFAULT_MESSAGES[options.code] ?? options.code;
+    super(message);
+    this.name = "UIFnError";
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.code = options.code;
+    this.package = options.package ?? "@uifn/core";
+    this.component = options.component;
+    this.details = options.details;
+    this.recoverable = options.recoverable ?? false;
+    this.cause = options.cause;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      package: this.package,
+      component: this.component,
+      message: this.message,
+      recoverable: this.recoverable,
+      details: this.details
+    };
+  }
+};
+function createUIFnError(options) {
+  return new UIFnError(options);
+}
+function isUIFnError(error) {
+  return error instanceof UIFnError;
+}
+function toUIFnErrorPayload(error, fallback = {}) {
+  if (isUIFnError(error)) {
+    return error.toJSON();
+  }
+  return createUIFnError({
+    code: fallback.code ?? "UIFN_ERR_TOOLCHAIN_MISCONFIG",
+    package: fallback.package ?? "@uifn/core",
+    component: fallback.component,
+    message: fallback.message ?? (error instanceof Error ? error.message : DEFAULT_MESSAGES.UIFN_ERR_TOOLCHAIN_MISCONFIG),
+    details: fallback.details ?? (error instanceof Error ? { originalErrorName: error.name } : error !== void 0 ? { originalError: error } : void 0),
+    recoverable: fallback.recoverable ?? false,
+    cause: fallback.cause ?? error
+  }).toJSON();
+}
+function assertContext(value, options = {}) {
+  if (value === null || value === void 0) {
+    throw createUIFnError({
+      code: "UIFN_ERR_CONTEXT_MISSING",
+      ...options,
+      recoverable: options.recoverable ?? false
+    });
+  }
+  return value;
+}
+function assertValidValue(condition, options = {}) {
+  if (!condition) {
+    throw createUIFnError({
+      code: "UIFN_ERR_INVALID_VALUE",
+      ...options,
+      recoverable: options.recoverable ?? false
+    });
+  }
+}
+function assertInRange(value, range, options = {}) {
+  const belowMin = range.min !== void 0 && value < range.min;
+  const aboveMax = range.max !== void 0 && value > range.max;
+  if (belowMin || aboveMax) {
+    throw createUIFnError({
+      code: "UIFN_ERR_RANGE_OUT_OF_BOUNDS",
+      ...options,
+      details: {
+        value,
+        min: range.min,
+        max: range.max,
+        ...options.details
+      },
+      recoverable: options.recoverable ?? false
+    });
+  }
+  return value;
+}
+function runIfEnabled(enabled, fn) {
+  if (!enabled) {
+    return false;
+  }
+  fn();
+  return true;
+}
+
+export { UIFN_ERROR_CODES, UIFnError, assertContext, assertInRange, assertValidValue, createUIFnError, isUIFnError, runIfEnabled, toUIFnErrorPayload };
+//# sourceMappingURL=chunk-HTTKRX7S.mjs.map
+//# sourceMappingURL=chunk-HTTKRX7S.mjs.map

package/dist/chunk-HTTKRX7S.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"chunk-HTTKRX7S.mjs","sourcesContent":["export type UIFnPackageName =\n  | '@uifn/core'\n  | '@uifn/react'\n  | '@uifn/svelte'\n  | '@uifn/vue'\n  | '@uifn/files';\n\nconst CANONICAL_UIFN_ERROR_CODES = [\n  'UIFN_ERR_A11Y_GATE_FAILURE',\n  'UIFN_ERR_CONTEXT_MISSING',\n  'UIFN_ERR_CONTROLLED_STATE_DIVERGENCE',\n  'UIFN_ERR_DETERMINISTIC_ID_MISMATCH',\n  'UIFN_ERR_DOCS_DRIFT',\n  'UIFN_ERR_DUPLICATE_PUBLIC_ID',\n  'UIFN_ERR_EXPORT_SURFACE_MISMATCH',\n  'UIFN_ERR_FILES_SCOPE_DRIFT',\n  'UIFN_ERR_HYDRATION_MISMATCH',\n  'UIFN_ERR_INVALID_VALUE',\n  'UIFN_ERR_MANUAL_EVIDENCE_INVALID',\n  'UIFN_ERR_MENU_NAVIGATION',\n  'UIFN_ERR_PACK_ARTIFACT_LEAK',\n  'UIFN_ERR_POSITIONING_OVERFLOW',\n  'UIFN_ERR_PUBLIC_SURFACE_DRIFT',\n  'UIFN_ERR_RANGE_OUT_OF_BOUNDS',\n  'UIFN_ERR_SCROLL_SYNC',\n  'UIFN_ERR_TEST_MATRIX_GAP',\n  'UIFN_ERR_TOOLCHAIN_MISCONFIG',\n  'UIFN_ERR_UNSUPPORTED_ENVIRONMENT',\n  'UIFN_ERR_UNSUPPORTED_PUBLIC_CLAIM',\n  'UIFN_ERR_WARNING_SUPPRESSED',\n  'UIFN_ERR_CONSUMER_SMOKE_FAILURE',\n  'UIFN_ERR_DIALOG_MODAL_INCOMPLETE',\n] as const;\n\n// Legacy codes still used by existing core primitives until later phases migrate those call sites.\nconst LEGACY_UIFN_ERROR_CODES = [\n  'UIFN_ERR_ASCHILD_CONTRACT',\n  'UIFN_ERR_COMBOBOX_FILTER_STATE',\n  'UIFN_ERR_DISABLED_INTERACTION',\n  'UIFN_ERR_SVELTE_REACTIVITY_SNAPSHOT',\n] as const;\n\nexport const UIFN_ERROR_CODES = [\n  ...CANONICAL_UIFN_ERROR_CODES,\n  ...LEGACY_UIFN_ERROR_CODES,\n] as const;\n\nexport type UIFnErrorCode = (typeof UIFN_ERROR_CODES)[number];\n\nexport interface UIFnErrorPayload {\n  name: 'UIFnError';\n  code: UIFnErrorCode;\n  package: UIFnPackageName;\n  component?: string;\n  message: string;\n  recoverable: boolean;\n  details?: Record<string, unknown>;\n}\n\nexport interface UIFnErrorOptions {\n  code: UIFnErrorCode;\n  package?: UIFnPackageName;\n  component?: string;\n  message?: string;\n  details?: Record<string, unknown>;\n  recoverable?: boolean;\n  cause?: unknown;\n}\n\nconst DEFAULT_MESSAGES: Partial<Record<UIFnErrorCode, string>> = {\n  UIFN_ERR_CONTEXT_MISSING: 'Required UI context is missing.',\n  UIFN_ERR_DETERMINISTIC_ID_MISMATCH: 'Public IDs MUST be deterministic across runtimes.',\n  UIFN_ERR_DUPLICATE_PUBLIC_ID: 'GA surfaces MUST NOT share fixed instance-scoped IDs.',\n  UIFN_ERR_INVALID_VALUE: 'Invalid public value for this surface.',\n  UIFN_ERR_RANGE_OUT_OF_BOUNDS: 'Public value is outside the supported range.',\n  UIFN_ERR_TOOLCHAIN_MISCONFIG: 'Verification failed due to toolchain misconfiguration.',\n  UIFN_ERR_UNSUPPORTED_ENVIRONMENT: 'Unsupported environment matrix for this package.',\n};\n\nexport class UIFnError extends Error {\n  readonly name = 'UIFnError';\n  readonly code: UIFnErrorCode;\n  readonly package: UIFnPackageName;\n  readonly component?: string;\n  readonly details?: Record<string, unknown>;\n  readonly recoverable: boolean;\n  readonly cause?: unknown;\n\n  constructor(options: UIFnErrorOptions) {\n    const message = options.message ?? DEFAULT_MESSAGES[options.code] ?? options.code;\n    super(message);\n\n    Object.setPrototypeOf(this, new.target.prototype);\n\n    this.code = options.code;\n    this.package = options.package ?? '@uifn/core';\n    this.component = options.component;\n    this.details = options.details;\n    this.recoverable = options.recoverable ?? false;\n    this.cause = options.cause;\n  }\n\n  toJSON(): UIFnErrorPayload {\n    return {\n      name: this.name,\n      code: this.code,\n      package: this.package,\n      component: this.component,\n      message: this.message,\n      recoverable: this.recoverable,\n      details: this.details,\n    };\n  }\n}\n\nexport function createUIFnError(options: UIFnErrorOptions): UIFnError {\n  return new UIFnError(options);\n}\n\nexport function isUIFnError(error: unknown): error is UIFnError {\n  return error instanceof UIFnError;\n}\n\nexport function toUIFnErrorPayload(\n  error: unknown,\n  fallback: Partial<UIFnErrorOptions> = {}\n): UIFnErrorPayload {\n  if (isUIFnError(error)) {\n    return error.toJSON();\n  }\n\n  return createUIFnError({\n    code: fallback.code ?? 'UIFN_ERR_TOOLCHAIN_MISCONFIG',\n    package: fallback.package ?? '@uifn/core',\n    component: fallback.component,\n    message:\n      fallback.message ??\n      (error instanceof Error ? error.message : DEFAULT_MESSAGES.UIFN_ERR_TOOLCHAIN_MISCONFIG),\n    details:\n      fallback.details ??\n      (error instanceof Error\n        ? { originalErrorName: error.name }\n        : error !== undefined\n          ? { originalError: error }\n          : undefined),\n    recoverable: fallback.recoverable ?? false,\n    cause: fallback.cause ?? error,\n  }).toJSON();\n}\n\ntype AssertionOptions = Omit<UIFnErrorOptions, 'code'>;\n\nexport function assertContext<T>(\n  value: T | null | undefined,\n  options: AssertionOptions = {}\n): T {\n  if (value === null || value === undefined) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_CONTEXT_MISSING',\n      ...options,\n      recoverable: options.recoverable ?? false,\n    });\n  }\n\n  return value;\n}\n\nexport function assertValidValue(\n  condition: boolean,\n  options: AssertionOptions = {}\n): void {\n  if (!condition) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_INVALID_VALUE',\n      ...options,\n      recoverable: options.recoverable ?? false,\n    });\n  }\n}\n\nexport function assertInRange(\n  value: number,\n  range: { min?: number; max?: number },\n  options: AssertionOptions = {}\n): number {\n  const belowMin = range.min !== undefined && value < range.min;\n  const aboveMax = range.max !== undefined && value > range.max;\n\n  if (belowMin || aboveMax) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_RANGE_OUT_OF_BOUNDS',\n      ...options,\n      details: {\n        value,\n        min: range.min,\n        max: range.max,\n        ...options.details,\n      },\n      recoverable: options.recoverable ?? false,\n    });\n  }\n\n  return value;\n}\n\nexport function runIfEnabled(enabled: boolean, fn: () => void): boolean {\n  if (!enabled) {\n    return false;\n  }\n\n  fn();\n  return true;\n}\n"]}

package/dist/chunk-II5OGIRE.mjs

@@ -0,0 +1,179 @@
+import { createUIFnError } from './chunk-HTTKRX7S.mjs';
+
+// src/utils/id.ts
+var DEFAULT_NAMESPACE = "uifn";
+var DEFAULT_PREFIX = "id";
+var TOKEN_SANITIZER = /[^a-z0-9-]+/g;
+var REPEATED_DASHES = /-+/g;
+function normalizeToken(token) {
+  return token.trim().toLowerCase().replace(TOKEN_SANITIZER, "-").replace(REPEATED_DASHES, "-").replace(/^-|-$/g, "");
+}
+function normalizeNamespace(namespace) {
+  return normalizeToken(namespace ?? DEFAULT_NAMESPACE) || DEFAULT_NAMESPACE;
+}
+function normalizePrefix(prefix) {
+  return normalizeToken(prefix ?? DEFAULT_PREFIX) || DEFAULT_PREFIX;
+}
+function normalizeExistingId(id) {
+  const normalized = normalizeToken(id);
+  if (!normalized) {
+    throw createUIFnError({
+      code: "UIFN_ERR_INVALID_VALUE",
+      package: "@uifn/core",
+      component: "PublicId",
+      message: "Public IDs MUST contain at least one non-empty segment.",
+      details: { id }
+    });
+  }
+  return normalized;
+}
+function normalizePublicIdInput(input) {
+  if (typeof input === "string") {
+    return {
+      prefix: normalizePrefix(input),
+      slot: ""
+    };
+  }
+  return {
+    prefix: normalizePrefix(input?.prefix),
+    slot: normalizeToken(input?.slot ?? "")
+  };
+}
+function composePublicIdBase(namespace, input) {
+  const normalized = normalizePublicIdInput(input);
+  const segments = normalized.prefix === namespace || normalized.prefix.startsWith(`${namespace}-`) ? [normalized.prefix] : [namespace, normalized.prefix];
+  if (normalized.slot) {
+    segments.push(normalized.slot);
+  }
+  return segments.join("-");
+}
+function createPublicIdRegistry() {
+  const issued = /* @__PURE__ */ new Set();
+  return {
+    has(id) {
+      return issued.has(normalizeExistingId(id));
+    },
+    register(id) {
+      const normalized = normalizeExistingId(id);
+      issued.add(normalized);
+      return normalized;
+    },
+    reset(prefix) {
+      if (!prefix) {
+        issued.clear();
+        return;
+      }
+      const normalizedPrefix = normalizeExistingId(prefix);
+      for (const id of issued) {
+        if (id === normalizedPrefix || id.startsWith(`${normalizedPrefix}-`)) {
+          issued.delete(id);
+        }
+      }
+    },
+    snapshot() {
+      return Array.from(issued).sort();
+    }
+  };
+}
+function assertUniquePublicId(id, registry = createPublicIdRegistry(), options = {}) {
+  const normalized = normalizeExistingId(id);
+  if (registry.has(normalized)) {
+    throw createUIFnError({
+      code: "UIFN_ERR_DUPLICATE_PUBLIC_ID",
+      package: options.package ?? "@uifn/core",
+      component: options.component,
+      message: "GA surfaces MUST NOT share fixed instance-scoped IDs.",
+      details: {
+        id: normalized,
+        ...options.details
+      },
+      recoverable: options.recoverable ?? false
+    });
+  }
+  registry.register(normalized);
+  return normalized;
+}
+function createDeterministicIdFactory(options = {}) {
+  const namespace = normalizeNamespace(options.namespace);
+  const counters = /* @__PURE__ */ new Map();
+  const registry = options.registry ?? createPublicIdRegistry();
+  const compose = (input) => composePublicIdBase(namespace, input);
+  return {
+    compose,
+    create(input = DEFAULT_PREFIX) {
+      const base = compose(input);
+      const nextCount = (counters.get(base) ?? 0) + 1;
+      counters.set(base, nextCount);
+      return assertUniquePublicId(`${base}-${nextCount}`, registry);
+    },
+    reuse(existingId, input = DEFAULT_PREFIX) {
+      if (existingId) {
+        return assertUniquePublicId(existingId, registry);
+      }
+      return this.create(input);
+    },
+    register(id, assertionOptions = {}) {
+      return assertUniquePublicId(id, registry, assertionOptions);
+    },
+    reset(input) {
+      if (!input) {
+        counters.clear();
+        registry.reset();
+        return;
+      }
+      const base = compose(input);
+      counters.delete(base);
+      registry.reset(base);
+    },
+    snapshot() {
+      return {
+        counters: Object.fromEntries(counters.entries()),
+        issued: registry.snapshot()
+      };
+    }
+  };
+}
+function composePublicId(input, options = {}) {
+  return composePublicIdBase(normalizeNamespace(options.namespace), input);
+}
+function createIdFactory(options = {}) {
+  const factory = createDeterministicIdFactory(options);
+  return {
+    next(token = DEFAULT_PREFIX) {
+      return factory.create(token);
+    },
+    reset(token) {
+      factory.reset(token);
+    },
+    snapshot() {
+      return factory.snapshot().counters;
+    }
+  };
+}
+var createIdScope = createIdFactory;
+var globalIdRegistry = createPublicIdRegistry();
+var globalIdFactory = createDeterministicIdFactory({
+  registry: globalIdRegistry
+});
+function generateId(token = DEFAULT_PREFIX) {
+  return globalIdFactory.create(token);
+}
+function reusePublicId(existingId, input) {
+  return globalIdFactory.reuse(existingId, input);
+}
+function registerPublicId(id, options = {}) {
+  return globalIdFactory.register(id, options);
+}
+function resetIdCounters(token) {
+  globalIdFactory.reset(token);
+}
+function getIdCounterSnapshot() {
+  return globalIdFactory.snapshot().counters;
+}
+function getPublicIdSnapshot() {
+  return globalIdFactory.snapshot();
+}
+
+export { assertUniquePublicId, composePublicId, createDeterministicIdFactory, createIdFactory, createIdScope, createPublicIdRegistry, generateId, getIdCounterSnapshot, getPublicIdSnapshot, registerPublicId, resetIdCounters, reusePublicId };
+//# sourceMappingURL=chunk-II5OGIRE.mjs.map
+//# sourceMappingURL=chunk-II5OGIRE.mjs.map

package/dist/chunk-II5OGIRE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/id.ts"],"names":[],"mappings":";;;AAEA,IAAM,iBAAA,GAAoB,MAAA;AAC1B,IAAM,cAAA,GAAiB,IAAA;AACvB,IAAM,eAAA,GAAkB,cAAA;AACxB,IAAM,eAAA,GAAkB,KAAA;AA6CxB,SAAS,eAAe,KAAA,EAAuB;AAC7C,EAAA,OAAO,KAAA,CACJ,IAAA,EAAK,CACL,WAAA,GACA,OAAA,CAAQ,eAAA,EAAiB,GAAG,CAAA,CAC5B,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAC5B,OAAA,CAAQ,UAAU,EAAE,CAAA;AACzB;AAEA,SAAS,mBAAmB,SAAA,EAA4B;AACtD,EAAA,OAAO,cAAA,CAAe,SAAA,IAAa,iBAAiB,CAAA,IAAK,iBAAA;AAC3D;AAEA,SAAS,gBAAgB,MAAA,EAAyB;AAChD,EAAA,OAAO,cAAA,CAAe,MAAA,IAAU,cAAc,CAAA,IAAK,cAAA;AACrD;AAEA,SAAS,oBAAoB,EAAA,EAAoB;AAC/C,EAAA,MAAM,UAAA,GAAa,eAAe,EAAE,CAAA;AACpC,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,MAAM,eAAA,CAAgB;AAAA,MACpB,IAAA,EAAM,wBAAA;AAAA,MACN,OAAA,EAAS,YAAA;AAAA,MACT,SAAA,EAAW,UAAA;AAAA,MACX,OAAA,EAAS,yDAAA;AAAA,MACT,OAAA,EAAS,EAAE,EAAA;AAAG,KACf,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,UAAA;AACT;AAEA,SAAS,uBAAuB,KAAA,EAAyD;AACvF,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,gBAAgB,KAAK,CAAA;AAAA,MAC7B,IAAA,EAAM;AAAA,KACR;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,eAAA,CAAgB,KAAA,EAAO,MAAM,CAAA;AAAA,IACrC,IAAA,EAAM,cAAA,CAAe,KAAA,EAAO,IAAA,IAAQ,EAAE;AAAA,GACxC;AACF;AAEA,SAAS,mBAAA,CAAoB,WAAmB,KAAA,EAAwC;AACtF,EAAA,MAAM,UAAA,GAAa,uBAAuB,KAAK,CAAA;AAC/C,EAAA,MAAM,WAAW,UAAA,CAAW,MAAA,KAAW,aAAa,UAAA,CAAW,MAAA,CAAO,WAAW,CAAA,EAAG,SAAS,CAAA,CAAA,CAAG,CAAA,GAC5F,CAAC,UAAA,CAAW,MAAM,IAClB,CAAC,SAAA,EAAW,WAAW,MAAM,CAAA;AAEjC,EAAA,IAAI,WAAW,IAAA,EAAM;AACnB,IAAA,QAAA,CAAS,IAAA,CAAK,WAAW,IAAI,CAAA;AAAA,EAC/B;AAEA,EAAA,OAAO,QAAA,CAAS,KAAK,GAAG,CAAA;AAC1B;AAEO,SAAS,sBAAA,GAA2C;AACzD,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAY;AAE/B,EAAA,OAAO;AAAA,IACL,IAAI,EAAA,EAAI;AACN,MAAA,OAAO,MAAA,CAAO,GAAA,CAAI,mBAAA,CAAoB,EAAE,CAAC,CAAA;AAAA,IAC3C,CAAA;AAAA,IACA,SAAS,EAAA,EAAI;AACX,MAAA,MAAM,UAAA,GAAa,oBAAoB,EAAE,CAAA;AACzC,MAAA,MAAA,CAAO,IAAI,UAAU,CAAA;AACrB,MAAA,OAAO,UAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,MAAA,EAAQ;AACZ,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,MAAA,CAAO,KAAA,EAAM;AACb,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,gBAAA,GAAmB,oBAAoB,MAAM,CAAA;AACnD,MAAA,KAAA,MAAW,MAAM,MAAA,EAAQ;AACvB,QAAA,IAAI,OAAO,gBAAA,IAAoB,EAAA,CAAG,WAAW,CAAA,EAAG,gBAAgB,GAAG,CAAA,EAAG;AACpE,UAAA,MAAA,CAAO,OAAO,EAAE,CAAA;AAAA,QAClB;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IACA,QAAA,GAAW;AACT,MAAA,OAAO,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA,CAAE,IAAA,EAAK;AAAA,IACjC;AAAA,GACF;AACF;AAEO,SAAS,qBACd,EAAA,EACA,QAAA,GAA6B,wBAAuB,EACpD,OAAA,GAAoC,EAAC,EAC7B;AACR,EAAA,MAAM,UAAA,GAAa,oBAAoB,EAAE,CAAA;AAEzC,EAAA,IAAI,QAAA,CAAS,GAAA,CAAI,UAAU,CAAA,EAAG;AAC5B,IAAA,MAAM,eAAA,CAAgB;AAAA,MACpB,IAAA,EAAM,8BAAA;AAAA,MACN,OAAA,EAAS,QAAQ,OAAA,IAAW,YAAA;AAAA,MAC5B,WAAW,OAAA,CAAQ,SAAA;AAAA,MACnB,OAAA,EAAS,uDAAA;AAAA,MACT,OAAA,EAAS;AAAA,QACP,EAAA,EAAI,UAAA;AAAA,QACJ,GAAG,OAAA,CAAQ;AAAA,OACb;AAAA,MACA,WAAA,EAAa,QAAQ,WAAA,IAAe;AAAA,KACrC,CAAA;AAAA,EACH;AAEA,EAAA,QAAA,CAAS,SAAS,UAAU,CAAA;AAC5B,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,4BAAA,CACd,OAAA,GAA8D,EAAC,EACvC;AACxB,EAAA,MAAM,SAAA,GAAY,kBAAA,CAAmB,OAAA,CAAQ,SAAS,CAAA;AACtD,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAoB;AACzC,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,QAAA,IAAY,sBAAA,EAAuB;AAE5D,EAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAAmC,mBAAA,CAAoB,WAAW,KAAK,CAAA;AAExF,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,MAAA,CAAO,QAAQ,cAAA,EAAgB;AAC7B,MAAA,MAAM,IAAA,GAAO,QAAQ,KAAK,CAAA;AAC1B,MAAA,MAAM,SAAA,GAAA,CAAa,QAAA,CAAS,GAAA,CAAI,IAAI,KAAK,CAAA,IAAK,CAAA;AAC9C,MAAA,QAAA,CAAS,GAAA,CAAI,MAAM,SAAS,CAAA;AAC5B,MAAA,OAAO,qBAAqB,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,SAAS,IAAI,QAAQ,CAAA;AAAA,IAC9D,CAAA;AAAA,IACA,KAAA,CAAM,UAAA,EAAY,KAAA,GAAQ,cAAA,EAAgB;AACxC,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,OAAO,oBAAA,CAAqB,YAAY,QAAQ,CAAA;AAAA,MAClD;AAEA,MAAA,OAAO,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,IAC1B,CAAA;AAAA,IACA,QAAA,CAAS,EAAA,EAAI,gBAAA,GAAmB,EAAC,EAAG;AAClC,MAAA,OAAO,oBAAA,CAAqB,EAAA,EAAI,QAAA,EAAU,gBAAgB,CAAA;AAAA,IAC5D,CAAA;AAAA,IACA,MAAM,KAAA,EAAO;AACX,MAAA,IAAI,CAAC,KAAA,EAAO;AACV,QAAA,QAAA,CAAS,KAAA,EAAM;AACf,QAAA,QAAA,CAAS,KAAA,EAAM;AACf,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,IAAA,GAAO,QAAQ,KAAK,CAAA;AAC1B,MAAA,QAAA,CAAS,OAAO,IAAI,CAAA;AACpB,MAAA,QAAA,CAAS,MAAM,IAAI,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,QAAA,GAAW;AACT,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,MAAA,CAAO,WAAA,CAAY,QAAA,CAAS,SAAS,CAAA;AAAA,QAC/C,MAAA,EAAQ,SAAS,QAAA;AAAS,OAC5B;AAAA,IACF;AAAA,GACF;AACF;AAEO,SAAS,eAAA,CACd,KAAA,EACA,OAAA,GAA4B,EAAC,EACrB;AACR,EAAA,OAAO,mBAAA,CAAoB,kBAAA,CAAmB,OAAA,CAAQ,SAAS,GAAG,KAAK,CAAA;AACzE;AAEO,SAAS,eAAA,CAAgB,OAAA,GAA4B,EAAC,EAAc;AACzE,EAAA,MAAM,OAAA,GAAU,6BAA6B,OAAO,CAAA;AAEpD,EAAA,OAAO;AAAA,IACL,IAAA,CAAK,QAAQ,cAAA,EAAgB;AAC3B,MAAA,OAAO,OAAA,CAAQ,OAAO,KAAK,CAAA;AAAA,IAC7B,CAAA;AAAA,IACA,MAAM,KAAA,EAAgB;AACpB,MAAA,OAAA,CAAQ,MAAM,KAAK,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,QAAA,GAAW;AACT,MAAA,OAAO,OAAA,CAAQ,UAAS,CAAE,QAAA;AAAA,IAC5B;AAAA,GACF;AACF;AAEO,IAAM,aAAA,GAAgB;AAE7B,IAAM,mBAAmB,sBAAA,EAAuB;AAChD,IAAM,kBAAkB,4BAAA,CAA6B;AAAA,EACnD,QAAA,EAAU;AACZ,CAAC,CAAA;AAEM,SAAS,UAAA,CAAW,QAAQ,cAAA,EAAwB;AACzD,EAAA,OAAO,eAAA,CAAgB,OAAO,KAAK,CAAA;AACrC;AAEO,SAAS,aAAA,CACd,YACA,KAAA,EACQ;AACR,EAAA,OAAO,eAAA,CAAgB,KAAA,CAAM,UAAA,EAAY,KAAK,CAAA;AAChD;AAEO,SAAS,gBAAA,CACd,EAAA,EACA,OAAA,GAAoC,EAAC,EAC7B;AACR,EAAA,OAAO,eAAA,CAAgB,QAAA,CAAS,EAAA,EAAI,OAAO,CAAA;AAC7C;AAEO,SAAS,gBAAgB,KAAA,EAAsB;AACpD,EAAA,eAAA,CAAgB,MAAM,KAAK,CAAA;AAC7B;AAEO,SAAS,oBAAA,GAA+C;AAC7D,EAAA,OAAO,eAAA,CAAgB,UAAS,CAAE,QAAA;AACpC;AAEO,SAAS,mBAAA,GAAwC;AACtD,EAAA,OAAO,gBAAgB,QAAA,EAAS;AAClC","file":"chunk-II5OGIRE.mjs","sourcesContent":["import { createUIFnError, type UIFnPackageName } from '../errors';\n\nconst DEFAULT_NAMESPACE = 'uifn';\nconst DEFAULT_PREFIX = 'id';\nconst TOKEN_SANITIZER = /[^a-z0-9-]+/g;\nconst REPEATED_DASHES = /-+/g;\n\nexport interface IdFactoryOptions {\n  namespace?: string;\n}\n\nexport interface IdFactory {\n  next: (token?: string) => string;\n  reset: (token?: string) => void;\n  snapshot: () => Record<string, number>;\n}\n\nexport interface PublicIdInput {\n  prefix?: string;\n  slot?: string;\n}\n\nexport interface PublicIdAssertionOptions {\n  package?: UIFnPackageName;\n  component?: string;\n  details?: Record<string, unknown>;\n  recoverable?: boolean;\n}\n\nexport interface PublicIdSnapshot {\n  counters: Record<string, number>;\n  issued: string[];\n}\n\nexport interface PublicIdRegistry {\n  has: (id: string) => boolean;\n  register: (id: string) => string;\n  reset: (prefix?: string) => void;\n  snapshot: () => string[];\n}\n\nexport interface DeterministicIdFactory {\n  compose: (input?: string | PublicIdInput) => string;\n  create: (input?: string | PublicIdInput) => string;\n  reuse: (existingId: string | null | undefined, input?: string | PublicIdInput) => string;\n  register: (id: string, options?: PublicIdAssertionOptions) => string;\n  reset: (input?: string | PublicIdInput) => void;\n  snapshot: () => PublicIdSnapshot;\n}\n\nfunction normalizeToken(token: string): string {\n  return token\n    .trim()\n    .toLowerCase()\n    .replace(TOKEN_SANITIZER, '-')\n    .replace(REPEATED_DASHES, '-')\n    .replace(/^-|-$/g, '');\n}\n\nfunction normalizeNamespace(namespace?: string): string {\n  return normalizeToken(namespace ?? DEFAULT_NAMESPACE) || DEFAULT_NAMESPACE;\n}\n\nfunction normalizePrefix(prefix?: string): string {\n  return normalizeToken(prefix ?? DEFAULT_PREFIX) || DEFAULT_PREFIX;\n}\n\nfunction normalizeExistingId(id: string): string {\n  const normalized = normalizeToken(id);\n  if (!normalized) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_INVALID_VALUE',\n      package: '@uifn/core',\n      component: 'PublicId',\n      message: 'Public IDs MUST contain at least one non-empty segment.',\n      details: { id },\n    });\n  }\n\n  return normalized;\n}\n\nfunction normalizePublicIdInput(input?: string | PublicIdInput): Required<PublicIdInput> {\n  if (typeof input === 'string') {\n    return {\n      prefix: normalizePrefix(input),\n      slot: '',\n    };\n  }\n\n  return {\n    prefix: normalizePrefix(input?.prefix),\n    slot: normalizeToken(input?.slot ?? ''),\n  };\n}\n\nfunction composePublicIdBase(namespace: string, input?: string | PublicIdInput): string {\n  const normalized = normalizePublicIdInput(input);\n  const segments = normalized.prefix === namespace || normalized.prefix.startsWith(`${namespace}-`)\n    ? [normalized.prefix]\n    : [namespace, normalized.prefix];\n\n  if (normalized.slot) {\n    segments.push(normalized.slot);\n  }\n\n  return segments.join('-');\n}\n\nexport function createPublicIdRegistry(): PublicIdRegistry {\n  const issued = new Set<string>();\n\n  return {\n    has(id) {\n      return issued.has(normalizeExistingId(id));\n    },\n    register(id) {\n      const normalized = normalizeExistingId(id);\n      issued.add(normalized);\n      return normalized;\n    },\n    reset(prefix) {\n      if (!prefix) {\n        issued.clear();\n        return;\n      }\n\n      const normalizedPrefix = normalizeExistingId(prefix);\n      for (const id of issued) {\n        if (id === normalizedPrefix || id.startsWith(`${normalizedPrefix}-`)) {\n          issued.delete(id);\n        }\n      }\n    },\n    snapshot() {\n      return Array.from(issued).sort();\n    },\n  };\n}\n\nexport function assertUniquePublicId(\n  id: string,\n  registry: PublicIdRegistry = createPublicIdRegistry(),\n  options: PublicIdAssertionOptions = {}\n): string {\n  const normalized = normalizeExistingId(id);\n\n  if (registry.has(normalized)) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_DUPLICATE_PUBLIC_ID',\n      package: options.package ?? '@uifn/core',\n      component: options.component,\n      message: 'GA surfaces MUST NOT share fixed instance-scoped IDs.',\n      details: {\n        id: normalized,\n        ...options.details,\n      },\n      recoverable: options.recoverable ?? false,\n    });\n  }\n\n  registry.register(normalized);\n  return normalized;\n}\n\nexport function createDeterministicIdFactory(\n  options: IdFactoryOptions & { registry?: PublicIdRegistry } = {}\n): DeterministicIdFactory {\n  const namespace = normalizeNamespace(options.namespace);\n  const counters = new Map<string, number>();\n  const registry = options.registry ?? createPublicIdRegistry();\n\n  const compose = (input?: string | PublicIdInput) => composePublicIdBase(namespace, input);\n\n  return {\n    compose,\n    create(input = DEFAULT_PREFIX) {\n      const base = compose(input);\n      const nextCount = (counters.get(base) ?? 0) + 1;\n      counters.set(base, nextCount);\n      return assertUniquePublicId(`${base}-${nextCount}`, registry);\n    },\n    reuse(existingId, input = DEFAULT_PREFIX) {\n      if (existingId) {\n        return assertUniquePublicId(existingId, registry);\n      }\n\n      return this.create(input);\n    },\n    register(id, assertionOptions = {}) {\n      return assertUniquePublicId(id, registry, assertionOptions);\n    },\n    reset(input) {\n      if (!input) {\n        counters.clear();\n        registry.reset();\n        return;\n      }\n\n      const base = compose(input);\n      counters.delete(base);\n      registry.reset(base);\n    },\n    snapshot() {\n      return {\n        counters: Object.fromEntries(counters.entries()),\n        issued: registry.snapshot(),\n      };\n    },\n  };\n}\n\nexport function composePublicId(\n  input?: string | PublicIdInput,\n  options: IdFactoryOptions = {}\n): string {\n  return composePublicIdBase(normalizeNamespace(options.namespace), input);\n}\n\nexport function createIdFactory(options: IdFactoryOptions = {}): IdFactory {\n  const factory = createDeterministicIdFactory(options);\n\n  return {\n    next(token = DEFAULT_PREFIX) {\n      return factory.create(token);\n    },\n    reset(token?: string) {\n      factory.reset(token);\n    },\n    snapshot() {\n      return factory.snapshot().counters;\n    },\n  };\n}\n\nexport const createIdScope = createIdFactory;\n\nconst globalIdRegistry = createPublicIdRegistry();\nconst globalIdFactory = createDeterministicIdFactory({\n  registry: globalIdRegistry,\n});\n\nexport function generateId(token = DEFAULT_PREFIX): string {\n  return globalIdFactory.create(token);\n}\n\nexport function reusePublicId(\n  existingId: string | null | undefined,\n  input?: string | PublicIdInput\n): string {\n  return globalIdFactory.reuse(existingId, input);\n}\n\nexport function registerPublicId(\n  id: string,\n  options: PublicIdAssertionOptions = {}\n): string {\n  return globalIdFactory.register(id, options);\n}\n\nexport function resetIdCounters(token?: string): void {\n  globalIdFactory.reset(token);\n}\n\nexport function getIdCounterSnapshot(): Record<string, number> {\n  return globalIdFactory.snapshot().counters;\n}\n\nexport function getPublicIdSnapshot(): PublicIdSnapshot {\n  return globalIdFactory.snapshot();\n}\n"]}

package/dist/chunk-JBMGXJ55.js

@@ -0,0 +1,136 @@
+'use strict';
+
+// src/utils/presence.ts
+function parseTimeListMs(value) {
+  const tokens = value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  if (tokens.length === 0) {
+    return 0;
+  }
+  return tokens.reduce((max, token) => {
+    const duration = token.endsWith("ms") ? Number.parseFloat(token) : Number.parseFloat(token) * 1e3;
+    return Number.isFinite(duration) ? Math.max(max, duration) : max;
+  }, 0);
+}
+function detectMotionFromStyles(styles) {
+  const animationDurationMs = parseTimeListMs(styles.animationDuration || "0s");
+  const transitionDurationMs = parseTimeListMs(styles.transitionDuration || "0s");
+  const hasAnimation = styles.animationName !== "none" && styles.animationName !== "" && animationDurationMs > 0;
+  const hasTransition = transitionDurationMs > 0;
+  return {
+    hasAnimation,
+    hasTransition,
+    animationDurationMs,
+    transitionDurationMs
+  };
+}
+function detectNodeMotion(node) {
+  const ownerWindow = node.ownerDocument.defaultView;
+  if (!ownerWindow) {
+    return {
+      hasAnimation: false,
+      hasTransition: false,
+      animationDurationMs: 0,
+      transitionDurationMs: 0
+    };
+  }
+  return detectMotionFromStyles(ownerWindow.getComputedStyle(node));
+}
+function shouldSuspendUnmount(snapshot) {
+  return snapshot.wasPresent && !snapshot.present && (snapshot.hasAnimation || snapshot.hasTransition);
+}
+function resolvePresenceState(snapshot) {
+  if (snapshot.present) {
+    return "mounted";
+  }
+  if (shouldSuspendUnmount(snapshot)) {
+    return "unmount-suspended";
+  }
+  return "unmounted";
+}
+function createPresenceManager(present, options = {}) {
+  let state = {
+    present,
+    state: present ? "mounted" : "unmounted",
+    reducedMotion: options.reducedMotion ?? false,
+    timers: 0,
+    listeners: 0,
+    cleanupComplete: !present
+  };
+  const getState = () => ({ ...state });
+  const updateCleanupState = () => {
+    state = {
+      ...state,
+      cleanupComplete: !state.present && state.timers === 0 && state.listeners === 0
+    };
+  };
+  return {
+    getState,
+    setPresent(nextPresent, motion) {
+      const hasAnimation = state.reducedMotion ? false : motion?.hasAnimation ?? false;
+      const hasTransition = state.reducedMotion ? false : motion?.hasTransition ?? false;
+      const nextPresenceState = resolvePresenceState({
+        present: nextPresent,
+        wasPresent: state.present,
+        hasAnimation,
+        hasTransition
+      });
+      state = {
+        ...state,
+        present: nextPresent,
+        state: nextPresenceState
+      };
+      updateCleanupState();
+      return getState();
+    },
+    registerTimer() {
+      state = {
+        ...state,
+        timers: state.timers + 1
+      };
+      updateCleanupState();
+      return getState();
+    },
+    clearTimer() {
+      state = {
+        ...state,
+        timers: Math.max(0, state.timers - 1)
+      };
+      updateCleanupState();
+      return getState();
+    },
+    registerListener() {
+      state = {
+        ...state,
+        listeners: state.listeners + 1
+      };
+      updateCleanupState();
+      return getState();
+    },
+    clearListener() {
+      state = {
+        ...state,
+        listeners: Math.max(0, state.listeners - 1)
+      };
+      updateCleanupState();
+      return getState();
+    },
+    cleanup() {
+      state = {
+        ...state,
+        timers: 0,
+        listeners: 0,
+        state: state.present ? "mounted" : "unmounted"
+      };
+      updateCleanupState();
+      return getState();
+    }
+  };
+}
+
+exports.createPresenceManager = createPresenceManager;
+exports.detectMotionFromStyles = detectMotionFromStyles;
+exports.detectNodeMotion = detectNodeMotion;
+exports.resolvePresenceState = resolvePresenceState;
+exports.shouldSuspendUnmount = shouldSuspendUnmount;
+//# sourceMappingURL=chunk-JBMGXJ55.js.map
+//# sourceMappingURL=chunk-JBMGXJ55.js.map

package/dist/chunk-JBMGXJ55.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/presence.ts"],"names":[],"mappings":"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","file":"chunk-JBMGXJ55.js","sourcesContent":["export interface PresenceSnapshot {\n  present: boolean;\n  wasPresent: boolean;\n  hasAnimation: boolean;\n  hasTransition: boolean;\n}\n\nexport type PresenceState = 'mounted' | 'unmount-suspended' | 'unmounted';\n\nexport interface MotionInfo {\n  hasAnimation: boolean;\n  hasTransition: boolean;\n  animationDurationMs: number;\n  transitionDurationMs: number;\n}\n\nexport interface PresenceManagerState {\n  present: boolean;\n  state: PresenceState;\n  reducedMotion: boolean;\n  timers: number;\n  listeners: number;\n  cleanupComplete: boolean;\n}\n\nexport interface PresenceManager {\n  getState: () => PresenceManagerState;\n  setPresent: (\n    present: boolean,\n    motion?: Pick<MotionInfo, 'hasAnimation' | 'hasTransition'>\n  ) => PresenceManagerState;\n  registerTimer: () => PresenceManagerState;\n  clearTimer: () => PresenceManagerState;\n  registerListener: () => PresenceManagerState;\n  clearListener: () => PresenceManagerState;\n  cleanup: () => PresenceManagerState;\n}\n\nexport interface PresenceManagerOptions {\n  reducedMotion?: boolean;\n}\n\nfunction parseTimeListMs(value: string): number {\n  const tokens = value\n    .split(',')\n    .map((entry) => entry.trim())\n    .filter(Boolean);\n  if (tokens.length === 0) {\n    return 0;\n  }\n\n  return tokens.reduce((max, token) => {\n    const duration = token.endsWith('ms')\n      ? Number.parseFloat(token)\n      : Number.parseFloat(token) * 1000;\n    return Number.isFinite(duration) ? Math.max(max, duration) : max;\n  }, 0);\n}\n\nexport function detectMotionFromStyles(\n  styles: Pick<\n    CSSStyleDeclaration,\n    'animationName' | 'animationDuration' | 'transitionDuration'\n  >\n): MotionInfo {\n  const animationDurationMs = parseTimeListMs(styles.animationDuration || '0s');\n  const transitionDurationMs = parseTimeListMs(styles.transitionDuration || '0s');\n\n  const hasAnimation =\n    styles.animationName !== 'none' &&\n    styles.animationName !== '' &&\n    animationDurationMs > 0;\n  const hasTransition = transitionDurationMs > 0;\n\n  return {\n    hasAnimation,\n    hasTransition,\n    animationDurationMs,\n    transitionDurationMs,\n  };\n}\n\nexport function detectNodeMotion(node: HTMLElement): MotionInfo {\n  const ownerWindow = node.ownerDocument.defaultView;\n  if (!ownerWindow) {\n    return {\n      hasAnimation: false,\n      hasTransition: false,\n      animationDurationMs: 0,\n      transitionDurationMs: 0,\n    };\n  }\n\n  return detectMotionFromStyles(ownerWindow.getComputedStyle(node));\n}\n\nexport function shouldSuspendUnmount(snapshot: PresenceSnapshot): boolean {\n  return (\n    snapshot.wasPresent &&\n    !snapshot.present &&\n    (snapshot.hasAnimation || snapshot.hasTransition)\n  );\n}\n\nexport function resolvePresenceState(snapshot: PresenceSnapshot): PresenceState {\n  if (snapshot.present) {\n    return 'mounted';\n  }\n\n  if (shouldSuspendUnmount(snapshot)) {\n    return 'unmount-suspended';\n  }\n\n  return 'unmounted';\n}\n\nexport function createPresenceManager(\n  present: boolean,\n  options: PresenceManagerOptions = {}\n): PresenceManager {\n  let state: PresenceManagerState = {\n    present,\n    state: present ? 'mounted' : 'unmounted',\n    reducedMotion: options.reducedMotion ?? false,\n    timers: 0,\n    listeners: 0,\n    cleanupComplete: !present,\n  };\n\n  const getState = (): PresenceManagerState => ({ ...state });\n\n  const updateCleanupState = () => {\n    state = {\n      ...state,\n      cleanupComplete: !state.present && state.timers === 0 && state.listeners === 0,\n    };\n  };\n\n  return {\n    getState,\n    setPresent(nextPresent, motion) {\n      const hasAnimation = state.reducedMotion ? false : motion?.hasAnimation ?? false;\n      const hasTransition = state.reducedMotion ? false : motion?.hasTransition ?? false;\n      const nextPresenceState = resolvePresenceState({\n        present: nextPresent,\n        wasPresent: state.present,\n        hasAnimation,\n        hasTransition,\n      });\n\n      state = {\n        ...state,\n        present: nextPresent,\n        state: nextPresenceState,\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n    registerTimer() {\n      state = {\n        ...state,\n        timers: state.timers + 1,\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n    clearTimer() {\n      state = {\n        ...state,\n        timers: Math.max(0, state.timers - 1),\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n    registerListener() {\n      state = {\n        ...state,\n        listeners: state.listeners + 1,\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n    clearListener() {\n      state = {\n        ...state,\n        listeners: Math.max(0, state.listeners - 1),\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n    cleanup() {\n      state = {\n        ...state,\n        timers: 0,\n        listeners: 0,\n        state: state.present ? 'mounted' : 'unmounted',\n      };\n\n      updateCleanupState();\n      return getState();\n    },\n  };\n}\n"]}

package/dist/chunk-K3WYDUIN.js

@@ -0,0 +1,60 @@
+'use strict';
+
+// src/primitives/shared.ts
+function createStore(initialState) {
+  let state = initialState;
+  const listeners = /* @__PURE__ */ new Set();
+  const getState = () => state;
+  const setState = (nextState, meta) => {
+    state = nextState;
+    listeners.forEach((listener) => listener(state, meta));
+  };
+  const patchState = (partial, meta) => {
+    setState({ ...state, ...partial }, meta);
+  };
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  };
+  return {
+    getState,
+    setState,
+    patchState,
+    subscribe
+  };
+}
+function uniqueStrings(values) {
+  return Array.from(new Set(values.filter(Boolean)));
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function alignToStep(value, min, step) {
+  if (step <= 0) {
+    return value;
+  }
+  const distance = value - min;
+  const steps = Math.round(distance / step);
+  return min + steps * step;
+}
+function shallowArrayEqual(a, b) {
+  if (a.length !== b.length) {
+    return false;
+  }
+  for (let index = 0; index < a.length; index += 1) {
+    if (a[index] !== b[index]) {
+      return false;
+    }
+  }
+  return true;
+}
+
+exports.alignToStep = alignToStep;
+exports.clamp = clamp;
+exports.createStore = createStore;
+exports.shallowArrayEqual = shallowArrayEqual;
+exports.uniqueStrings = uniqueStrings;
+//# sourceMappingURL=chunk-K3WYDUIN.js.map
+//# sourceMappingURL=chunk-K3WYDUIN.js.map

package/dist/chunk-K3WYDUIN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/shared.ts"],"names":[],"mappings":";;;AAeO,SAAS,YAAsC,YAAA,EAAsB;AAC1E,EAAA,IAAI,KAAA,GAAQ,YAAA;AACZ,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAgC;AAEtD,EAAA,MAAM,WAAW,MAAM,KAAA;AAEvB,EAAA,MAAM,QAAA,GAAW,CAAC,SAAA,EAAmB,IAAA,KAA8B;AACjE,IAAA,KAAA,GAAQ,SAAA;AACR,IAAA,SAAA,CAAU,QAAQ,CAAC,QAAA,KAAa,QAAA,CAAS,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,EACvD,CAAA;AAEA,EAAA,MAAM,UAAA,GAAa,CAAC,OAAA,EAA0B,IAAA,KAA8B;AAC1E,IAAA,QAAA,CAAS,EAAE,GAAG,KAAA,EAAO,GAAG,OAAA,IAAW,IAAI,CAAA;AAAA,EACzC,CAAA;AAEA,EAAA,MAAM,SAAA,GAAY,CAAC,QAAA,KAAyC;AAC1D,IAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,IAC3B,CAAA;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,QAAA;AAAA,IACA,UAAA;AAAA,IACA;AAAA,GACF;AACF;AAEO,SAAS,cAAc,MAAA,EAA4B;AACxD,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,GAAA,CAAI,OAAO,MAAA,CAAO,OAAO,CAAC,CAAC,CAAA;AACnD;AAEO,SAAS,KAAA,CAAM,KAAA,EAAe,GAAA,EAAa,GAAA,EAAqB;AACrE,EAAA,OAAO,KAAK,GAAA,CAAI,IAAA,CAAK,IAAI,KAAA,EAAO,GAAG,GAAG,GAAG,CAAA;AAC3C;AAEO,SAAS,WAAA,CAAY,KAAA,EAAe,GAAA,EAAa,IAAA,EAAsB;AAC5E,EAAA,IAAI,QAAQ,CAAA,EAAG;AACb,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,WAAW,KAAA,GAAQ,GAAA;AACzB,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,QAAA,GAAW,IAAI,CAAA;AACxC,EAAA,OAAO,MAAM,KAAA,GAAQ,IAAA;AACvB;AAEO,SAAS,iBAAA,CAAqB,GAAQ,CAAA,EAAiB;AAC5D,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,KAAA,IAAS,QAAQ,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAE,MAAA,EAAQ,SAAS,CAAA,EAAG;AAChD,IAAA,IAAI,CAAA,CAAE,KAAK,CAAA,KAAM,CAAA,CAAE,KAAK,CAAA,EAAG;AACzB,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT","file":"chunk-K3WYDUIN.js","sourcesContent":["export type ChangeSource = 'user' | 'programmatic' | 'controlled-sync';\n\nexport interface ChangeMeta<TValue = unknown> {\n  source: ChangeSource;\n  reason: string;\n  previousValue: TValue;\n  nextValue: TValue;\n  inputModality?: 'keyboard' | 'pointer' | 'touch' | 'virtual';\n}\n\nexport type Subscriber<TState, TValue = unknown> = (\n  state: TState,\n  meta?: ChangeMeta<TValue>\n) => void;\n\nexport function createStore<TState, TValue = unknown>(initialState: TState) {\n  let state = initialState;\n  const listeners = new Set<Subscriber<TState, TValue>>();\n\n  const getState = () => state;\n\n  const setState = (nextState: TState, meta?: ChangeMeta<TValue>) => {\n    state = nextState;\n    listeners.forEach((listener) => listener(state, meta));\n  };\n\n  const patchState = (partial: Partial<TState>, meta?: ChangeMeta<TValue>) => {\n    setState({ ...state, ...partial }, meta);\n  };\n\n  const subscribe = (listener: Subscriber<TState, TValue>) => {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  return {\n    getState,\n    setState,\n    patchState,\n    subscribe,\n  };\n}\n\nexport function uniqueStrings(values: string[]): string[] {\n  return Array.from(new Set(values.filter(Boolean)));\n}\n\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\nexport function alignToStep(value: number, min: number, step: number): number {\n  if (step <= 0) {\n    return value;\n  }\n\n  const distance = value - min;\n  const steps = Math.round(distance / step);\n  return min + steps * step;\n}\n\nexport function shallowArrayEqual<T>(a: T[], b: T[]): boolean {\n  if (a.length !== b.length) {\n    return false;\n  }\n\n  for (let index = 0; index < a.length; index += 1) {\n    if (a[index] !== b[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"]}

package/dist/chunk-K626K7M2.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-K626K7M2.mjs.map
+//# sourceMappingURL=chunk-K626K7M2.mjs.map

package/dist/chunk-K626K7M2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-K626K7M2.mjs"}