@gringow/gringow 0.1.2 → 0.1.3

package/README.md

@@ -15,73 +15,115 @@ yarn add @gringow/gringow
 ## Usage
 
 ```typescript
-import Gringow from '@gringow/gringow'
+import Gringow, { rebuild } from '@gringow/gringow'
 
 // Simple string translation
-const result = await Gringow`Hello world`
-console.log(result.translation) // { "pt-BR": "Olá mundo", "fr-CA": "Bonjour le monde" }
-
-// Template string translation
-const name = "John"
-const result2 = await Gringow`Hello ${name}`
-console.log(result2.translation) // { "pt-BR": "Olá João", "fr-CA": "Bonjour John" }
+const { cacheId, translation } = await Gringow`Hello world`
+console.log(cacheId) // deterministic cache ID created from the flattened string
+console.log(translation.translation) // { "pt-BR": "Olá mundo", "fr-CA": "Bonjour le monde" }
+
+// Template string translation (values are flattened before hashing)
+const name = 'John'
+const { translation: hiJohn } = await Gringow`Hello ${name}`
+console.log(hiJohn.translation) // { "pt-BR": "Olá John", "fr-CA": "Bonjour John" }
+
+// Re-run an existing cache entry against the configured LLM
+const refreshed = await rebuild(cacheId)
+console.log(refreshed.translation.translation)
 ```
 
+Gringow always returns a `{ cacheId, translation }` object. The `translation` payload can include optional
+`prepend`/`append` strings when you use custom prompts.
+
 ## Configuration
 
-Create a `gringow.config.js` file in your project root:
+Gringow loads configuration via `cosmiconfig` using the `gringow` namespace. You can place any of the supported
+formats in your project root (e.g. `gringow.config.js`, `gringow.config.mjs`, `gringow.config.json`). Missing fields
+are merged with the defaults below and validated with Zod.
 
-```javascript
+```js
+// gringow.config.js
 export default {
-  sourceLanguage: "en-US",
-  languages: ["pt-BR", "fr-CA"],
-  llm: {
-    choice: "huggingface", // or "anthropic", "gemini"
-    model: "Xenova/nllb-200-distilled-600M"
+  debug: false,
+  log: { level: 'debug' },
+  cache: {
+    dir: './gringow',
+    file: 'gringow.json',
+    prefix: 'grw',
+    write: true, // set to false to skip writing to disk
   },
   keys: {
-    // anthropicApiKey: "your-key-here", // if using Anthropic
-    // geminiApiKey: "your-key-here"     // if using Gemini
-  }
+    anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+    geminiApiKey: process.env.GEMINI_API_KEY,
+  },
+  sourceLanguage: 'en-US',
+  languages: ['pt-BR', 'fr-CA'],
+  llm: {
+    choice: 'huggingface', // 'huggingface' | 'anthropic' | 'gemini'
+    model: 'Xenova/nllb-200-distilled-600M',
+    temperature: 1.0,
+    sleep: 0,
+    // Prompt shaping (all optional)
+    prePrompt: undefined,
+    postPrompt: undefined,
+    prePromptAppend: undefined,
+    postPromptPrepend: undefined,
+    prePromptReplace: undefined,
+    postPromptReplace: undefined,
+  },
+  // Files scanned by the Vite/Next.js plugins when building caches
+  globby: './src/**/*.{js,jsx,ts,tsx}',
 }
 ```
 
-## LLM Providers
-
-- **Hugging Face** (default): Local models, no API key required
-- **Anthropic**: Requires `anthropicApiKey`
-- **Gemini**: Requires `geminiApiKey`
+> For `anthropic` or `gemini`, the corresponding API key **must** be present or config validation will fail.
 
-## API
+## LLM Providers
 
-### Gringow(strings, ...values)
+- **Hugging Face** (default): Runs local models, no API key required.
+- **Anthropic**: Requires `keys.anthropicApiKey`.
+- **Gemini**: Requires `keys.geminiApiKey`.
 
-Main function for template string translation.
+## API surface
 
-**Parameters:**
-- `strings`: TemplateStringsArray or string
-- `values`: Values for interpolation
+- `default export Gringow(strings, ...values)` — translate a string or tagged template. Returns a `Promise<GringowResponse>`.
+- `rebuild(cacheId)` — re-asks the configured LLM for a cached entry and writes it back when `cache.write` is true.
+- Cache helpers: `checkCache`, `getCache`, `getOrCreateCache`, `writeCacheToDisk`, `deleteCacheItem`, `clearCache`.
+- Utilities: `createCacheId`, `flatTemplateString`, `interpolateTemplate` (browser build), `awaitedConfig`, `isLocalConfigFound`, `getConfigSource`.
 
-**Returns:** Promise<GringowResponse>
+```ts
+type GringowTranslation = Record<string, string>
 
-### GringowResponse
+type GringowCacheItem = {
+  original: string
+  translation: GringowTranslation
+  append?: string
+  prepend?: string
+  rebuild?: boolean
+}
 
-```typescript
 type GringowResponse = {
   cacheId: string
   translation: GringowCacheItem
 }
+```
 
-type GringowCacheItem = {
-  original: string
-  translation: GringowTranslation
-}
+## Development
 
-type GringowTranslation = {
-  [key: string]: string
-}
+```bash
+pnpm install
+pnpm run build   # builds the package
+pnpm run test    # vitest suite
 ```
 
 ## License
 
-MIT
+MIT
+
+## Related Packages (npm)
+
+- [@gringow/gringow-cli](https://www.npmjs.com/package/@gringow/gringow-cli) - Command-line interface
+- [@gringow/gringow-shadow](https://www.npmjs.com/package/@gringow/gringow-shadow) - Web Component layer powering the React bindings
+- [@gringow/gringow-react](https://www.npmjs.com/package/@gringow/gringow-react) - React bindings
+- [@gringow/gringow-vite](https://www.npmjs.com/package/@gringow/gringow-vite) - Vite plugin
+- [@gringow/gringow-nextjs](https://www.npmjs.com/package/@gringow/gringow-nextjs) - Experimental Next.js plugin

package/dist/browser.d.mts

@@ -1,5 +1,6 @@
-export { createCacheId } from './data/create-cache-id.mjs';
+export { createCacheId } from './create-cache-id.mjs';
 export { flatTemplateString } from './flat-template-string.mjs';
+export { interpolateTemplate } from './interpolate-template.mjs';
 
 declare const GRINGOW_IO_URL = "https://gringow.io";
 

package/dist/browser.mjs

@@ -1,8 +1,52 @@
-import CryptoJS from 'crypto-js';
+// src/data/md5.ts
+var INITIAL_STATE = [1831565813, 461845907, 2246822507, 3266489909];
+var MULTIPLIERS = [668265261, 374761393, 2654435769, 2496678331];
+var AVA_MULT1 = 2146121005;
+var AVA_MULT2 = 2221713035;
+function seedState(input) {
+  const state = [...INITIAL_STATE];
+  for (const char of input) {
+    const codePoint = char.codePointAt(0) ?? 0;
+    for (let i = 0; i < state.length; i++) {
+      state[i] = Math.imul(state[i] ^ codePoint, MULTIPLIERS[i]);
+      state[i] = rotateLeft(state[i], (i + 1) * 3);
+    }
+    state[0] ^= state[3] >>> 11;
+    state[1] ^= state[0] << 7;
+    state[2] ^= state[1] >>> 13;
+    state[3] ^= state[2] << 5;
+  }
+  return state;
+}
+function rotateLeft(value, shift) {
+  return value << shift | value >>> 32 - shift;
+}
+function avalanche(value) {
+  value ^= value >>> 16;
+  value = Math.imul(value, AVA_MULT1);
+  value ^= value >>> 15;
+  value = Math.imul(value, AVA_MULT2);
+  value ^= value >>> 16;
+  return value >>> 0;
+}
+function toHex(value) {
+  return (value >>> 0).toString(16).padStart(8, "0");
+}
+function mixState([h1, h2, h3, h4]) {
+  h1 = avalanche(h1 ^ h3);
+  h2 = avalanche(h2 ^ h4);
+  h3 = avalanche(h3 ^ h1);
+  h4 = avalanche(h4 ^ h2);
+  return [h1, h2, h3, h4];
+}
+function md5(input) {
+  const state = mixState(seedState(input));
+  return state.map(toHex).join("");
+}
 
-// src/data/create-cache-id.ts
+// src/create-cache-id.ts
 function createCacheId(text) {
-  const hexHash = CryptoJS.MD5(text).toString();
+  const hexHash = md5(text);
   const cacheId = `gid_${hexHash}`;
   return cacheId;
 }
@@ -22,7 +66,20 @@ function flatTemplateString(givenStrings, givenValues) {
   return flatted;
 }
 
+// src/interpolate-template.ts
+function interpolateTemplate(template, values) {
+  if (!values || values.length === 0) return template;
+  let valueIndex = 0;
+  return template.replace(/\$\{[^}]*\}/g, () => {
+    if (valueIndex < values.length) {
+      const value = values[valueIndex++];
+      return value === null || value === void 0 ? "" : String(value);
+    }
+    return "";
+  });
+}
+
 // src/browser.ts
 var GRINGOW_IO_URL = "https://gringow.io";
 
-export { GRINGOW_IO_URL, createCacheId, flatTemplateString };
+export { GRINGOW_IO_URL, createCacheId, flatTemplateString, interpolateTemplate };

package/dist/config.mjs

@@ -107,9 +107,9 @@ async function loadUserConfig() {
 var awaitedConfig = loadUserConfig();
 function defaultPrePrompt(config, extraInstructions) {
   return `
-You are a translation generator.
+You are a ultimate translation generator server api.
 
-Your task is to output **only one valid JSON object**, with **no text, explanations, or formatting outside the JSON**.
+Your task is to translate a given text and output **only one valid JSON object**, with **no text, explanations, or formatting than the JSON**.
 
 Follow these rules strictly:
 
@@ -119,7 +119,7 @@ Follow these rules strictly:
    - Apply these creatively but **without altering the meaning or punctuation** of the original text.
 3. Produce translations naturally, as a **professional human translator** would.
 4. Respect the original punctuation, sentence boundaries, and capitalization.
-5. Consider only the following target languages: ${(config?.languages ? config.languages : []).join(", ")}.
+5. Consider only the following target languages: ${(config?.languages ? Array.from(/* @__PURE__ */ new Set(["es-ES", ...config.languages, config.sourceLanguage])) : []).join(", ")}.
 6. The final output must be a **valid JSON** following this exact schema:
 
 {

package/dist/config.test.mjs

@@ -1392,7 +1392,7 @@ var require_utils = __commonJS({
 // ../node_modules/.pnpm/expect-type@1.2.2/node_modules/expect-type/dist/index.js
 var require_dist = __commonJS({
   "../node_modules/.pnpm/expect-type@1.2.2/node_modules/expect-type/dist/index.js"(exports) {
-    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m3, k2, k22) {
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m3, k2, k22) {
       if (k22 === void 0) k22 = k2;
       var desc = Object.getOwnPropertyDescriptor(m3, k2);
       if (!desc || ("get" in desc ? !m3.__esModule : desc.writable || desc.configurable)) {
@@ -1401,10 +1401,10 @@ var require_dist = __commonJS({
         } };
       }
       Object.defineProperty(o, k22, desc);
-    } : function(o, m3, k2, k22) {
+    }) : (function(o, m3, k2, k22) {
       if (k22 === void 0) k22 = k2;
       o[k22] = m3[k2];
-    });
+    }));
     var __exportStar = exports && exports.__exportStar || function(m3, exports2) {
       for (var p4 in m3) if (p4 !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p4)) __createBinding(exports2, m3, p4);
     };
@@ -13239,7 +13239,7 @@ function findTestFileStackTrace(error, each) {
 globalThis.performance ? globalThis.performance.now.bind(globalThis.performance) : Date.now;
 globalThis.performance ? globalThis.performance.now.bind(globalThis.performance) : Date.now;
 
-// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4/node_modules/vitest/dist/chunks/utils.C8RiOc4B.js
+// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4_lightningcss@1.30.2_terser@5.44.1/node_modules/vitest/dist/chunks/utils.C8RiOc4B.js
 var NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
   const workerState = globalThis[NAME_WORKER_STATE];
@@ -13299,7 +13299,7 @@ async function waitForImportsToResolve() {
   await waitForImportsToResolve();
 }
 
-// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
+// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4_lightningcss@1.30.2_terser@5.44.1/node_modules/vitest/dist/chunks/_commonjsHelpers.BFTU3MAI.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 function getDefaultExportFromCjs2(x2) {
   return x2 && x2.__esModule && Object.prototype.hasOwnProperty.call(x2, "default") ? x2["default"] : x2;
@@ -15333,7 +15333,7 @@ var SnapshotClient = class {
   }
 };
 
-// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4/node_modules/vitest/dist/chunks/date.W2xKR2qe.js
+// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4_lightningcss@1.30.2_terser@5.44.1/node_modules/vitest/dist/chunks/date.W2xKR2qe.js
 var RealDate = Date;
 var now2 = null;
 var MockDate = class _MockDate extends RealDate {
@@ -15386,7 +15386,7 @@ function resetDate() {
   globalThis.Date = RealDate;
 }
 
-// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4/node_modules/vitest/dist/chunks/vi.DgezovHB.js
+// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4_lightningcss@1.30.2_terser@5.44.1/node_modules/vitest/dist/chunks/vi.DgezovHB.js
 var unsupported = [
   // .poll is meant to retry matchers until they succeed, and
   // snapshots will always succeed as long as the poll method doesn't thow an error
@@ -16215,7 +16215,7 @@ function requireTypeDetect() {
   (function(module, exports) {
     (function(global3, factory) {
       module.exports = factory();
-    })(typeDetect, function() {
+    })(typeDetect, (function() {
       var promiseExists = typeof Promise === "function";
       var globalObject = typeof self === "object" ? self : commonjsGlobal;
       var symbolExists = typeof Symbol !== "undefined";
@@ -16324,7 +16324,7 @@ function requireTypeDetect() {
         return Object.prototype.toString.call(obj).slice(toStringLeftSliceLength, toStringRightSliceLength);
       }
       return typeDetect2;
-    });
+    }));
   })(typeDetect$1);
   return typeDetect$1.exports;
 }
@@ -18118,7 +18118,7 @@ function getImporter(name) {
   return stack?.file || "";
 }
 
-// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4/node_modules/vitest/dist/index.js
+// ../node_modules/.pnpm/vitest@2.1.9_@types+node@22.16.4_lightningcss@1.30.2_terser@5.44.1/node_modules/vitest/dist/index.js
 __toESM(require_dist(), 1);
 
 // src/constants/default-config.ts
@@ -18218,9 +18218,9 @@ async function loadUserConfig() {
 loadUserConfig();
 function defaultPrePrompt(config2, extraInstructions) {
   return `
-You are a translation generator.
+You are a ultimate translation generator server api.
 
-Your task is to output **only one valid JSON object**, with **no text, explanations, or formatting outside the JSON**.
+Your task is to translate a given text and output **only one valid JSON object**, with **no text, explanations, or formatting than the JSON**.
 
 Follow these rules strictly:
 
@@ -18230,7 +18230,7 @@ Follow these rules strictly:
    - Apply these creatively but **without altering the meaning or punctuation** of the original text.
 3. Produce translations naturally, as a **professional human translator** would.
 4. Respect the original punctuation, sentence boundaries, and capitalization.
-5. Consider only the following target languages: ${(config2?.languages ? config2.languages : []).join(", ")}.
+5. Consider only the following target languages: ${(config2?.languages ? Array.from(/* @__PURE__ */ new Set(["es-ES", ...config2.languages, config2.sourceLanguage])) : []).join(", ")}.
 6. The final output must be a **valid JSON** following this exact schema:
 
 {
@@ -18273,26 +18273,27 @@ function postPrompt(config2, prepend, replace) {
 // src/config.test.ts
 describe("config", () => {
   describe("defaultPrePrompt", () => {
-    it("should generate pre-message prompt with correct languages", () => {
+    it("should describe translation task with configured languages", () => {
       const config2 = {
         ...defaultConfig,
         languages: ["pt-BR", "fr-CA", "es-ES"]
       };
       const result2 = defaultPrePrompt(config2);
+      globalExpect(result2).toContain("You are a translation generator.");
+      globalExpect(result2).toContain("Your task is to output **only one valid JSON object**");
       globalExpect(result2).toContain("pt-BR, fr-CA, es-ES");
-      globalExpect(result2).toContain("[PRE-MESSAGE]");
-      globalExpect(result2).toContain("[/PRE-MESSAGE]");
-      globalExpect(result2).toContain('"original"');
-      globalExpect(result2).toContain('"translation"');
+      globalExpect(result2).toContain('"original": "<original input text>"');
+      globalExpect(result2).toContain('"translation": {');
     });
-    it("should include JSON example in prompt", () => {
+    it("should include extraInstructions block when provided", () => {
       const config2 = {
         ...defaultConfig,
         languages: ["pt-BR"]
       };
-      const result2 = defaultPrePrompt(config2);
-      globalExpect(result2).toContain('"en-US": "The quick brown fox jumps over the lazy dog"');
-      globalExpect(result2).toContain('"pt-BR": "A r\xE1pida raposa marrom salta sobre o c\xE3o pregui\xE7oso"');
+      const result2 = defaultPrePrompt(config2, "Use pirate voice");
+      globalExpect(result2).toContain("Now, using these instructions and applying the following extra parameters:");
+      globalExpect(result2).toContain("extraInstructions: Use pirate voice");
+      globalExpect(result2).toContain("Translate the following text faithfully:");
     });
   });
   describe("defaultPostPrompt", () => {
@@ -18301,87 +18302,69 @@ describe("config", () => {
         ...defaultConfig
       });
       const result2 = defaultPostPrompt();
-      globalExpect(result2).toContain("[POST-MESSAGE]");
-      globalExpect(result2).toContain("[/POST-MESSAGE]");
-      globalExpect(result2).toContain("DO NOT WRAP IT IN A CODE BLOCK");
-      globalExpect(result2).toContain("FIRST CHARACTER MUST BE A {");
-      globalExpect(result2).toContain("LAST CHARACTER MUST BE A }");
+      globalExpect(result2).toBe("");
     });
   });
   describe("prePrompt", () => {
     it("should use prePromptReplace when provided", () => {
       const config2 = {
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
+        ...defaultConfig
       };
-      const result2 = prePrompt(config2);
+      const result2 = prePrompt(config2, void 0, "Custom pre-prompt");
       globalExpect(result2).toBe("Custom pre-prompt");
     });
     it("should use prePromptAppend when provided", () => {
       const config2 = {
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
+        ...defaultConfig
       };
-      const result2 = prePrompt(config2);
-      globalExpect(result2).toContain("Additional instructions");
-      globalExpect(result2).toContain("[PRE-MESSAGE]");
+      const result2 = prePrompt(config2, "Additional instructions");
+      globalExpect(result2).toContain("extraInstructions: Additional instructions");
+      globalExpect(result2).toContain("You are a translation generator.");
     });
     it("should use prePromptReplace and prePromptAppend together", () => {
       const config2 = {
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
+        ...defaultConfig
       };
-      const result2 = prePrompt(config2);
-      globalExpect(result2).toBe("Custom pre-prompt Additional instructions");
+      const result2 = prePrompt(config2, "Additional instructions", "Custom pre-prompt");
+      globalExpect(result2).toBe("Custom pre-prompt");
     });
     it("should use default prompt when no customization is provided", () => {
       const config2 = {
         ...defaultConfig
       };
       const result2 = prePrompt(config2);
-      globalExpect(result2).toContain("[PRE-MESSAGE]");
-      globalExpect(result2).toContain("[/PRE-MESSAGE]");
+      globalExpect(result2).toContain("You are a translation generator.");
+      globalExpect(result2).toContain("Translate the following text faithfully:");
     });
   });
   describe("postPrompt", () => {
     it("should use postPromptReplace when provided", () => {
-      ({
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
-      });
-      const result2 = postPrompt();
+      const config2 = {
+        ...defaultConfig
+      };
+      const result2 = postPrompt(config2, void 0, "Custom post-prompt");
       globalExpect(result2).toBe("Custom post-prompt");
     });
     it("should use postPromptPrepend when provided", () => {
-      ({
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
-      });
-      const result2 = postPrompt();
-      globalExpect(result2).toContain("Additional post instructions");
-      globalExpect(result2).toContain("[POST-MESSAGE]");
+      const config2 = {
+        ...defaultConfig
+      };
+      const result2 = postPrompt(config2, "Additional post instructions");
+      globalExpect(result2).toBe("[SPECIFIC_INPUTS] Additional post instructions [/SPECIFIC_INPUTS]");
     });
     it("should use postPromptReplace and postPromptPrepend together", () => {
-      ({
-        ...defaultConfig,
-        llm: {
-          ...defaultConfig.llm}
-      });
-      const result2 = postPrompt();
-      globalExpect(result2).toBe("Additional post instructions Custom post-prompt");
+      const config2 = {
+        ...defaultConfig
+      };
+      const result2 = postPrompt(config2, "Additional post instructions", "Custom post-prompt");
+      globalExpect(result2).toBe("[SPECIFIC_INPUTS] Additional post instructions [/SPECIFIC_INPUTS] Custom post-prompt");
     });
     it("should use default prompt when no customization is provided", () => {
       ({
         ...defaultConfig
       });
       const result2 = postPrompt();
-      globalExpect(result2).toContain("[POST-MESSAGE]");
-      globalExpect(result2).toContain("[/POST-MESSAGE]");
+      globalExpect(result2).toBe("");
     });
   });
 });

package/dist/{data/create-cache-id.d.mts → create-cache-id.d.mts}

@@ -1,8 +1,8 @@
 /**
- * Creates a unique cache ID for a given text using MD5 hash
+ * Creates a stable cache ID for a given text using a deterministic hash
  *
  * @param text - The text string to create a cache ID for
- * @returns MD5 hash of the text as a hex string
+ * @returns Deterministic hash of the text as a hex string
  *
  * @example
  * const id = createCacheId("my text")

package/dist/create-cache-id.mjs

@@ -0,0 +1,54 @@
+// src/data/md5.ts
+var INITIAL_STATE = [1831565813, 461845907, 2246822507, 3266489909];
+var MULTIPLIERS = [668265261, 374761393, 2654435769, 2496678331];
+var AVA_MULT1 = 2146121005;
+var AVA_MULT2 = 2221713035;
+function seedState(input) {
+  const state = [...INITIAL_STATE];
+  for (const char of input) {
+    const codePoint = char.codePointAt(0) ?? 0;
+    for (let i = 0; i < state.length; i++) {
+      state[i] = Math.imul(state[i] ^ codePoint, MULTIPLIERS[i]);
+      state[i] = rotateLeft(state[i], (i + 1) * 3);
+    }
+    state[0] ^= state[3] >>> 11;
+    state[1] ^= state[0] << 7;
+    state[2] ^= state[1] >>> 13;
+    state[3] ^= state[2] << 5;
+  }
+  return state;
+}
+function rotateLeft(value, shift) {
+  return value << shift | value >>> 32 - shift;
+}
+function avalanche(value) {
+  value ^= value >>> 16;
+  value = Math.imul(value, AVA_MULT1);
+  value ^= value >>> 15;
+  value = Math.imul(value, AVA_MULT2);
+  value ^= value >>> 16;
+  return value >>> 0;
+}
+function toHex(value) {
+  return (value >>> 0).toString(16).padStart(8, "0");
+}
+function mixState([h1, h2, h3, h4]) {
+  h1 = avalanche(h1 ^ h3);
+  h2 = avalanche(h2 ^ h4);
+  h3 = avalanche(h3 ^ h1);
+  h4 = avalanche(h4 ^ h2);
+  return [h1, h2, h3, h4];
+}
+function md5(input) {
+  const state = mixState(seedState(input));
+  return state.map(toHex).join("");
+}
+
+// src/create-cache-id.ts
+function createCacheId(text) {
+  const hexHash = md5(text);
+  const cacheId = `gid_${hexHash}`;
+  return cacheId;
+}
+
+export { createCacheId };

package/dist/create-cache-id.test.d.mts

@@ -0,0 +1,2 @@
+
+export {  }