@forthtilliath/ts-kit 0.1.0 → 0.2.0

package/dist/files/downloadText.d.ts

@@ -8,6 +8,7 @@ export declare function downloadText(filename: string, text: string): void;
  * Downloads a text blob as a file.
  * @param filename The filename to save to.
  * @param text The text to save.
+ * @param mimeType The MIME type of the blob (defaults to `"text/plain"`).
  */
-export declare function downloadTextBlob(filename: string, text: string): void;
+export declare function downloadTextBlob(filename: string, text: string, mimeType?: string): void;
 //# sourceMappingURL=downloadText.d.ts.map

package/dist/files/downloadText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"downloadText.d.ts","sourceRoot":"","sources":["../../src/files/downloadText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAcjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYrE"}
+{"version":3,"file":"downloadText.d.ts","sourceRoot":"","sources":["../../src/files/downloadText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAe,GACtB,IAAI,CAcN"}

package/dist/files/downloadText.js

@@ -16,9 +16,10 @@ export function downloadText(filename, text) {
  * Downloads a text blob as a file.
  * @param filename The filename to save to.
  * @param text The text to save.
+ * @param mimeType The MIME type of the blob (defaults to `"text/plain"`).
  */
-export function downloadTextBlob(filename, text) {
-    const url = URL.createObjectURL(new Blob([text], { type: "text/plain" }));
+export function downloadTextBlob(filename, text, mimeType = "text/plain") {
+    const url = URL.createObjectURL(new Blob([text], { type: `${mimeType};charset=utf-8` }));
     const a = document.createElement("a");
     a.setAttribute("download", filename);
     a.setAttribute("href", url);

package/dist/id/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./randomId.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/id/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/id/index.js

@@ -0,0 +1 @@
+export * from "./randomId.js";

package/dist/id/randomId.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `crypto.randomUUID()` with a fallback. That API only exists in a secure
+ * context (HTTPS or `localhost`) and is missing on a few older browsers. The
+ * fallbacks are not cryptographically secure but are good enough for local
+ * identifiers.
+ *
+ * @returns {string} A UUID-v4-shaped string, or a timestamp-based id as a last resort.
+ */
+export declare function randomId(): string;
+//# sourceMappingURL=randomId.d.ts.map

package/dist/id/randomId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomId.d.ts","sourceRoot":"","sources":["../../src/id/randomId.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA6BjC"}

package/dist/id/randomId.js

@@ -0,0 +1,33 @@
+/**
+ * `crypto.randomUUID()` with a fallback. That API only exists in a secure
+ * context (HTTPS or `localhost`) and is missing on a few older browsers. The
+ * fallbacks are not cryptographically secure but are good enough for local
+ * identifiers.
+ *
+ * @returns {string} A UUID-v4-shaped string, or a timestamp-based id as a last resort.
+ */
+export function randomId() {
+    // `globalThis.crypto` is typed as always present by lib.dom, but it can be
+    // missing at runtime (older browser, insecure context) — cast it away so
+    // the checks below are not flagged as unnecessary.
+    const c = globalThis.crypto;
+    if (typeof c?.randomUUID === "function") {
+        return c.randomUUID();
+    }
+    if (typeof c?.getRandomValues === "function") {
+        const bytes = c.getRandomValues(new Uint8Array(16));
+        bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40; // version 4
+        bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80; // variant
+        const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
+        return (hex.slice(0, 4).join("") +
+            "-" +
+            hex.slice(4, 6).join("") +
+            "-" +
+            hex.slice(6, 8).join("") +
+            "-" +
+            hex.slice(8, 10).join("") +
+            "-" +
+            hex.slice(10, 16).join(""));
+    }
+    return `id-${Date.now().toString(16)}-${Math.random().toString(16).slice(2, 10)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/ts-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -24,7 +24,7 @@
     "jsdom": "^29.1.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@forthtilliath/eslint-config": "0.0.0",
+    "@forthtilliath/eslint-config": "0.1.0",
     "@forthtilliath/typescript-config": "0.0.0"
   },
   "scripts": {