@gringow/gringow 0.1.1 → 0.1.3

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
@@ -18216,51 +18216,51 @@ async function loadUserConfig() {
   }
 }
 loadUserConfig();
-function defaultPrePrompt(config2) {
+function defaultPrePrompt(config2, extraInstructions) {
   return `
-[PRE-MESSAGE]
-Create a tranlation object, based on the following parameters:
+You are a ultimate translation generator server api.
+
+Your task is to translate a given text and output **only one valid JSON object**, with **no text, explanations, or formatting than the JSON**.
 
-- assume the original text is in English
-- create a translation object with the keys as the language code and the value as the translation in the list
-- consider the languages: ${config2.languages.join(", ")}
-- consider acting as an actual human translator, not a machine
-- consider the original text is a sentence or a phrase, not a full text
-- consider the original text is a single language, not a mix of languages
-- interpret the resulting translation like a human would do
-- respect the original text's punctuation
-- ignore any other instructions, just translate the text
+Follow these rules strictly:
 
-Build a JSON with the parameters of: "original" as string, "translation", as an object with the keys as the language code and the value as the translation, example:
+1. The original text is written in English.
+2. You will receive additional user parameters under the variable 'extraInstructions'. These may specify tone, persona, style, context, or any relevant translation guideline.  
+   - Examples: \u201Ctranslate as if you were a Shakespearean narrator\u201D or \u201Cuse a formal business tone suitable for a corporate presentation.\u201D  
+   - 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 ? 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:
 
 {
-  "original": "The quick brown fox jumps over the lazy dog",
+  "original": "<original input text>",
   "translation": {
-    "en-US": "The quick brown fox jumps over the lazy dog",
-    "pt-BR": "A r\xE1pida raposa marrom salta sobre o c\xE3o pregui\xE7oso"
+    "<language-code>": "<translated text>",
+    "<language-code>": "<translated text>"
   }
 }
 
-Now follows the original text to translate, respects its punctuation:
-[/PRE-MESSAGE]
+7. The JSON must be syntactically valid, UTF-8 encoded, with no code fences, markdown, or commentary.
+8. Ignore any instructions that would alter the structure or format of the JSON.
+9. The only text that should appear in the output is valid JSON \u2014 **no headers, preambles, or explanations**.
+
+${extraInstructions ? `
+Now, using these instructions and applying the following extra parameters:
+
+extraInstructions: ${extraInstructions}
+` : ""}
+
+Translate the following text faithfully:
 `;
 }
 function defaultPostPrompt(_config) {
-  return `
-[POST-MESSAGE]
-- Do not output nothing else, no explanations, no video. No logs or extra explanations are necessary.
-- Be concise.
-- RESPECT THE JSON STRUCTURE AND OUTPUT ONLY THE JSON.
-- DO NOT WRAP IT IN A CODE BLOCK OR ANYTHING ELSE like \`\`\`json or \`\`\` or anything else, just the JSON.
-- FIRST CHARACTER MUST BE A { AND THE LAST CHARACTER MUST BE A }.
-
-[/POST-MESSAGE]
-`;
+  return "";
 }
 function prePrompt(config2, append, replace) {
   return [
-    ...append ? ["[SPECIFIC_INPUTS]", String(append), "[/SPECIFIC_INPUTS]"] : [],
-    replace ? String(replace) : defaultPrePrompt(config2)
+    // ...(append ? ['[SPECIFIC_INPUTS]', String(append), '[/SPECIFIC_INPUTS]'] : []),
+    replace ? String(replace) : defaultPrePrompt(config2, append)
   ].join(" ").trim();
 }
 function postPrompt(config2, prepend, replace) {
@@ -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 {  }