@ai-matrx/kit 0.7.4 → 0.8.0

package/dist/uuid.cjs

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/uuid.ts
+var uuid_exports = {};
+__export(uuid_exports, {
+  isRfc4122Uuid: () => isRfc4122Uuid,
+  isUuidShape: () => isUuidShape
+});
+module.exports = __toCommonJS(uuid_exports);
+var UUID_SHAPE_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var RFC_4122_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUuidShape(value) {
+  return typeof value === "string" && UUID_SHAPE_RE.test(value);
+}
+function isRfc4122Uuid(value) {
+  return typeof value === "string" && RFC_4122_RE.test(value);
+}
+//# sourceMappingURL=uuid.cjs.map

package/dist/uuid.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/uuid.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/uuid — the two UUID predicates the fleet actually uses, named\n * so that nobody can pick the wrong one by accident.\n *\n * WHY THIS FILE EXISTS (2026-09-07 duplication census, rows 6–8). The fleet had\n * TWO different predicates both called `isUuid`, and the difference was\n * invisible at the call site:\n *\n *   - `@ai-matrx/associations/core`'s — a LAX shape check (8-4-4-4-12 hex).\n *     Right for \"is this a database id or a slug?\", where a v7 id, a nil UUID\n *     and a hand-made test fixture must all pass.\n *   - Six matrx-frontend API doors' — a STRICT RFC-4122 check that additionally\n *     pins the version nibble to `1-5` and the variant nibble to `8/9/a/b`.\n *     Right for a validation door on a public route, where the only ids that\n *     should ever arrive are ones this system minted.\n *\n * They were never reconciled because there was no shared home; the census had\n * to allowlist two of them as \"provably a different capability\". Both now live\n * here, under names that say which is which, and `isUuid` is deliberately NOT\n * exported: a caller must choose.\n *\n * Note the strict predicate REJECTS values the lax one accepts, including the\n * nil UUID `00000000-0000-0000-0000-000000000000` and every UUIDv6/v7/v8 id.\n * Never swap one for the other to make a test pass.\n */\n\n/** 8-4-4-4-12 hex, any version, any variant. */\nconst UUID_SHAPE_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/** 8-4-4-4-12 hex with an RFC-4122 version (1–5) and variant (8/9/a/b). */\nconst RFC_4122_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * True when `value` has UUID *shape* — the right question for \"did I get an\n * id or a slug?\". Accepts every UUID version plus the nil UUID.\n */\nexport function isUuidShape(value: unknown): value is string {\n  return typeof value === \"string\" && UUID_SHAPE_RE.test(value);\n}\n\n/**\n * True when `value` is a syntactically valid RFC-4122 UUID (version 1–5,\n * variant 8/9/a/b) — the right question for a validation door on a public\n * route. Stricter than {@link isUuidShape}: rejects the nil UUID and v6/v7/v8.\n */\nexport function isRfc4122Uuid(value: unknown): value is string {\n  return typeof value === \"string\" && RFC_4122_RE.test(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,IAAM,gBACJ;AAGF,IAAM,cACJ;AAMK,SAAS,YAAY,OAAiC;AAC3D,SAAO,OAAO,UAAU,YAAY,cAAc,KAAK,KAAK;AAC9D;AAOO,SAAS,cAAc,OAAiC;AAC7D,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK,KAAK;AAC5D;","names":[]}

package/dist/uuid.d.cts

@@ -0,0 +1,38 @@
+/**
+ * @ai-matrx/kit/uuid — the two UUID predicates the fleet actually uses, named
+ * so that nobody can pick the wrong one by accident.
+ *
+ * WHY THIS FILE EXISTS (2026-09-07 duplication census, rows 6–8). The fleet had
+ * TWO different predicates both called `isUuid`, and the difference was
+ * invisible at the call site:
+ *
+ *   - `@ai-matrx/associations/core`'s — a LAX shape check (8-4-4-4-12 hex).
+ *     Right for "is this a database id or a slug?", where a v7 id, a nil UUID
+ *     and a hand-made test fixture must all pass.
+ *   - Six matrx-frontend API doors' — a STRICT RFC-4122 check that additionally
+ *     pins the version nibble to `1-5` and the variant nibble to `8/9/a/b`.
+ *     Right for a validation door on a public route, where the only ids that
+ *     should ever arrive are ones this system minted.
+ *
+ * They were never reconciled because there was no shared home; the census had
+ * to allowlist two of them as "provably a different capability". Both now live
+ * here, under names that say which is which, and `isUuid` is deliberately NOT
+ * exported: a caller must choose.
+ *
+ * Note the strict predicate REJECTS values the lax one accepts, including the
+ * nil UUID `00000000-0000-0000-0000-000000000000` and every UUIDv6/v7/v8 id.
+ * Never swap one for the other to make a test pass.
+ */
+/**
+ * True when `value` has UUID *shape* — the right question for "did I get an
+ * id or a slug?". Accepts every UUID version plus the nil UUID.
+ */
+declare function isUuidShape(value: unknown): value is string;
+/**
+ * True when `value` is a syntactically valid RFC-4122 UUID (version 1–5,
+ * variant 8/9/a/b) — the right question for a validation door on a public
+ * route. Stricter than {@link isUuidShape}: rejects the nil UUID and v6/v7/v8.
+ */
+declare function isRfc4122Uuid(value: unknown): value is string;
+
+export { isRfc4122Uuid, isUuidShape };

package/dist/uuid.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @ai-matrx/kit/uuid — the two UUID predicates the fleet actually uses, named
+ * so that nobody can pick the wrong one by accident.
+ *
+ * WHY THIS FILE EXISTS (2026-09-07 duplication census, rows 6–8). The fleet had
+ * TWO different predicates both called `isUuid`, and the difference was
+ * invisible at the call site:
+ *
+ *   - `@ai-matrx/associations/core`'s — a LAX shape check (8-4-4-4-12 hex).
+ *     Right for "is this a database id or a slug?", where a v7 id, a nil UUID
+ *     and a hand-made test fixture must all pass.
+ *   - Six matrx-frontend API doors' — a STRICT RFC-4122 check that additionally
+ *     pins the version nibble to `1-5` and the variant nibble to `8/9/a/b`.
+ *     Right for a validation door on a public route, where the only ids that
+ *     should ever arrive are ones this system minted.
+ *
+ * They were never reconciled because there was no shared home; the census had
+ * to allowlist two of them as "provably a different capability". Both now live
+ * here, under names that say which is which, and `isUuid` is deliberately NOT
+ * exported: a caller must choose.
+ *
+ * Note the strict predicate REJECTS values the lax one accepts, including the
+ * nil UUID `00000000-0000-0000-0000-000000000000` and every UUIDv6/v7/v8 id.
+ * Never swap one for the other to make a test pass.
+ */
+/**
+ * True when `value` has UUID *shape* — the right question for "did I get an
+ * id or a slug?". Accepts every UUID version plus the nil UUID.
+ */
+declare function isUuidShape(value: unknown): value is string;
+/**
+ * True when `value` is a syntactically valid RFC-4122 UUID (version 1–5,
+ * variant 8/9/a/b) — the right question for a validation door on a public
+ * route. Stricter than {@link isUuidShape}: rejects the nil UUID and v6/v7/v8.
+ */
+declare function isRfc4122Uuid(value: unknown): value is string;
+
+export { isRfc4122Uuid, isUuidShape };

package/dist/uuid.js

@@ -0,0 +1,14 @@
+// src/uuid.ts
+var UUID_SHAPE_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var RFC_4122_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUuidShape(value) {
+  return typeof value === "string" && UUID_SHAPE_RE.test(value);
+}
+function isRfc4122Uuid(value) {
+  return typeof value === "string" && RFC_4122_RE.test(value);
+}
+export {
+  isRfc4122Uuid,
+  isUuidShape
+};
+//# sourceMappingURL=uuid.js.map

package/dist/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/uuid.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/uuid — the two UUID predicates the fleet actually uses, named\n * so that nobody can pick the wrong one by accident.\n *\n * WHY THIS FILE EXISTS (2026-09-07 duplication census, rows 6–8). The fleet had\n * TWO different predicates both called `isUuid`, and the difference was\n * invisible at the call site:\n *\n *   - `@ai-matrx/associations/core`'s — a LAX shape check (8-4-4-4-12 hex).\n *     Right for \"is this a database id or a slug?\", where a v7 id, a nil UUID\n *     and a hand-made test fixture must all pass.\n *   - Six matrx-frontend API doors' — a STRICT RFC-4122 check that additionally\n *     pins the version nibble to `1-5` and the variant nibble to `8/9/a/b`.\n *     Right for a validation door on a public route, where the only ids that\n *     should ever arrive are ones this system minted.\n *\n * They were never reconciled because there was no shared home; the census had\n * to allowlist two of them as \"provably a different capability\". Both now live\n * here, under names that say which is which, and `isUuid` is deliberately NOT\n * exported: a caller must choose.\n *\n * Note the strict predicate REJECTS values the lax one accepts, including the\n * nil UUID `00000000-0000-0000-0000-000000000000` and every UUIDv6/v7/v8 id.\n * Never swap one for the other to make a test pass.\n */\n\n/** 8-4-4-4-12 hex, any version, any variant. */\nconst UUID_SHAPE_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/** 8-4-4-4-12 hex with an RFC-4122 version (1–5) and variant (8/9/a/b). */\nconst RFC_4122_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * True when `value` has UUID *shape* — the right question for \"did I get an\n * id or a slug?\". Accepts every UUID version plus the nil UUID.\n */\nexport function isUuidShape(value: unknown): value is string {\n  return typeof value === \"string\" && UUID_SHAPE_RE.test(value);\n}\n\n/**\n * True when `value` is a syntactically valid RFC-4122 UUID (version 1–5,\n * variant 8/9/a/b) — the right question for a validation door on a public\n * route. Stricter than {@link isUuidShape}: rejects the nil UUID and v6/v7/v8.\n */\nexport function isRfc4122Uuid(value: unknown): value is string {\n  return typeof value === \"string\" && RFC_4122_RE.test(value);\n}\n"],"mappings":";AA2BA,IAAM,gBACJ;AAGF,IAAM,cACJ;AAMK,SAAS,YAAY,OAAiC;AAC3D,SAAO,OAAO,UAAU,YAAY,cAAc,KAAK,KAAK;AAC9D;AAOO,SAAS,cAAc,OAAiC;AAC7D,SAAO,OAAO,UAAU,YAAY,YAAY,KAAK,KAAK;AAC5D;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/kit",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "The always-include AI Matrx kit: the little primitives every Matrx app speaks — autosave that never loses a keystroke, stale-response guards, clipboard with graceful fallbacks — one per subpath, tree-shaken to what you use.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,12 @@
     "indexeddb",
     "tailwind-colors",
     "qr-code",
-    "short-link"
+    "short-link",
+    "format",
+    "duration",
+    "file-size",
+    "escape-html",
+    "uuid"
   ],
   "repository": {
     "type": "git",
@@ -260,6 +265,36 @@
         "types": "./dist/short-link-react.d.cts",
         "default": "./dist/short-link-react.cjs"
       }
+    },
+    "./format": {
+      "import": {
+        "types": "./dist/format.d.ts",
+        "default": "./dist/format.js"
+      },
+      "require": {
+        "types": "./dist/format.d.cts",
+        "default": "./dist/format.cjs"
+      }
+    },
+    "./html-escape": {
+      "import": {
+        "types": "./dist/html-escape.d.ts",
+        "default": "./dist/html-escape.js"
+      },
+      "require": {
+        "types": "./dist/html-escape.d.cts",
+        "default": "./dist/html-escape.cjs"
+      }
+    },
+    "./uuid": {
+      "import": {
+        "types": "./dist/uuid.d.ts",
+        "default": "./dist/uuid.js"
+      },
+      "require": {
+        "types": "./dist/uuid.d.cts",
+        "default": "./dist/uuid.cjs"
+      }
     }
   },
   "dependencies": {