ciiic-translation-rules 1.0.0

package/dist/index.mjs

@@ -0,0 +1,437 @@
+// src/index.ts
+var TRANSLATION_RULES = {
+  /**
+   * Organisation name mappings
+   */
+  organisations: [
+    {
+      dutch: "Stimuleringsfonds Creatieve Industrie",
+      english: "Creative Industries Fund NL",
+      notes: 'Never shorten to just "Stimuleringsfonds" - always use the full name'
+    },
+    {
+      dutch: "Ministerie van OCW",
+      english: "Ministry of Education, Culture and Science"
+    },
+    {
+      dutch: "Rijksoverheid",
+      english: "Dutch Government"
+    },
+    {
+      dutch: "Mondriaan Fonds",
+      english: "Mondriaan Fund"
+    },
+    {
+      dutch: "Filmfonds",
+      english: "Netherlands Film Fund"
+    }
+  ],
+  /**
+   * Funding call name translations
+   * Some calls have official translations, others should remain unchanged
+   */
+  fundingCalls: [
+    {
+      dutch: "CIIIC Start: verkennend onderzoek naar immersive experiences",
+      english: "CIIIC Start: exploratory research into immersive experiences"
+    },
+    {
+      dutch: "CIIIC Kern: Vraaggestuurd praktijkgericht onderzoek naar immersive experiences",
+      english: "CIIIC Kern: Demand-driven practice-oriented research into immersive experiences"
+    },
+    {
+      dutch: "Artistic & Design Research for Immersive Experiences (ADRIE)",
+      english: "Artistic & Design Research for Immersive Experiences (ADRIE)",
+      notes: "Name stays the same in both languages"
+    },
+    {
+      dutch: "Immersive Tech for Learning & Inclusion (ITLI)",
+      english: "Immersive Tech for Learning & Inclusion (ITLI)",
+      notes: "Name stays the same in both languages"
+    }
+  ],
+  /**
+   * Terminology that can be used interchangeably or has specific translations
+   */
+  terminology: [
+    {
+      dutch: ["immersive experiences", "immersieve ervaringen"],
+      english: ["immersive experiences"],
+      notes: 'In Dutch, both "immersive experiences" (English) and "immersieve ervaringen" are acceptable. The abbreviation "IX" is common in both languages.'
+    },
+    {
+      dutch: ["call", "regeling"],
+      english: ["call", "funding call", "grant scheme"],
+      notes: 'The English word "call" is commonly used in Dutch. "Regeling" is the formal Dutch synonym.'
+    },
+    // Grant/Funding Terminology
+    {
+      dutch: ["subsidie", "financiering"],
+      english: ["grant", "funding"]
+    },
+    {
+      dutch: ["aanvraag", "aanvragen"],
+      english: ["application", "apply"]
+    },
+    {
+      dutch: ["bijdrage"],
+      english: ["contribution", "grant"]
+    },
+    {
+      dutch: ["toekenning"],
+      english: ["award", "allocation"]
+    },
+    {
+      dutch: ["begroting"],
+      english: ["budget"]
+    },
+    {
+      dutch: ["deadline", "sluitingsdatum"],
+      english: ["deadline", "closing date"]
+    },
+    {
+      dutch: ["honorarium"],
+      english: ["fee", "honorarium"]
+    },
+    {
+      dutch: ["penvoerder"],
+      english: ["lead applicant", "consortium lead"]
+    },
+    {
+      dutch: ["consortium"],
+      english: ["consortium"]
+    },
+    // Sector Terminology
+    {
+      dutch: ["creatieve industrie"],
+      english: ["creative industries"]
+    },
+    {
+      dutch: ["games", "gamesector"],
+      english: ["games", "games sector"]
+    },
+    {
+      dutch: ["extended reality", "XR"],
+      english: ["extended reality", "XR"]
+    },
+    {
+      dutch: ["virtual reality", "VR"],
+      english: ["virtual reality", "VR"]
+    },
+    {
+      dutch: ["augmented reality", "AR"],
+      english: ["augmented reality", "AR"]
+    },
+    {
+      dutch: ["ontwikkelaar"],
+      english: ["developer"]
+    },
+    {
+      dutch: ["ontwerper"],
+      english: ["designer"]
+    },
+    {
+      dutch: ["kunstenaar"],
+      english: ["artist"]
+    },
+    {
+      dutch: ["maker"],
+      english: ["maker", "creator"]
+    }
+  ],
+  /**
+   * Terms that should NEVER be translated
+   */
+  neverTranslate: [
+    "CIIIC",
+    "ADRIE",
+    "ITLI",
+    "IX",
+    "IFFR",
+    "Eurosonic Noorderslag",
+    "ESNS",
+    // Social handles and hashtags
+    "@CIIIC_NL",
+    "#immersiveexperiences",
+    // Partner platform names
+    "Circle",
+    "Notion",
+    // Event names that stay the same
+    "Dutch Game Garden",
+    "Indigo",
+    "Control Conference"
+  ],
+  /**
+   * Government policies and official terms
+   * Keep in original language, use quotes if needed
+   */
+  officialTerms: [
+    {
+      term: "Rijksbrede Innovatie Agenda",
+      language: "dutch",
+      notes: "No official English translation - keep in Dutch with quotes"
+    }
+  ],
+  /**
+   * Button/CTA text translations
+   */
+  ctaTranslations: [
+    { dutch: "Lees meer", english: "Read more" },
+    { dutch: "Lees verder", english: "Read more" },
+    { dutch: "Meer informatie", english: "More information" },
+    { dutch: "Schrijf je in", english: "Register" },
+    { dutch: "Meld je aan", english: "Sign up" },
+    { dutch: "Aanmelden", english: "Register" },
+    { dutch: "Bekijk de agenda", english: "View the agenda" },
+    { dutch: "Naar de website", english: "Go to website" },
+    { dutch: "Download", english: "Download" },
+    { dutch: "Deel dit bericht", english: "Share this" }
+  ],
+  /**
+   * CIIIC-specific role and term translations
+   */
+  ciiicSpecifics: [
+    { dutch: "Programmadirecteur", english: "Programme Director" },
+    { dutch: "Projectleider", english: "Project Lead" },
+    { dutch: "Communicatie & Marketing", english: "Communications & Marketing" },
+    { dutch: "Adviseur", english: "Advisor" },
+    { dutch: "Co\xF6rdinator", english: "Coordinator" },
+    { dutch: "Communityplatform", english: "Community Platform" }
+  ],
+  /**
+   * Newsletter-specific phrases
+   */
+  newsletterPhrases: [
+    { dutch: "Bekijk deze e-mail in je browser", english: "View this email in your browser" },
+    { dutch: "Uitschrijven", english: "Unsubscribe" },
+    { dutch: "Voorkeuren aanpassen", english: "Update your preferences" },
+    { dutch: "Beste lezer", english: "Dear reader" },
+    { dutch: "Met vriendelijke groet", english: "Kind regards" },
+    { dutch: "Hartelijke groet", english: "Warm regards" },
+    { dutch: "In deze nieuwsbrief", english: "In this newsletter" }
+  ]
+};
+function generateTerminologyPrompt() {
+  const lines = [];
+  lines.push("TERMINOLOGY & TRANSLATION RULES:");
+  lines.push("");
+  lines.push("Organisation names:");
+  for (const org of TRANSLATION_RULES.organisations) {
+    lines.push(`  - "${org.dutch}" (Dutch) = "${org.english}" (English)`);
+    if (org.notes) {
+      lines.push(`    Note: ${org.notes}`);
+    }
+  }
+  lines.push("");
+  lines.push("Funding call translations (use these exact translations):");
+  for (const call of TRANSLATION_RULES.fundingCalls) {
+    if (call.dutch === call.english) {
+      lines.push(`  - "${call.dutch}" - same in both languages`);
+    } else {
+      lines.push(`  - Dutch: "${call.dutch}"`);
+      lines.push(`    English: "${call.english}"`);
+    }
+    if (call.notes) {
+      lines.push(`    Note: ${call.notes}`);
+    }
+  }
+  lines.push("");
+  lines.push("Terminology guidelines:");
+  for (const term of TRANSLATION_RULES.terminology) {
+    lines.push(`  - Dutch options: ${term.dutch.map((t) => `"${t}"`).join(", ")}`);
+    lines.push(`    English options: ${term.english.map((t) => `"${t}"`).join(", ")}`);
+    if (term.notes) {
+      lines.push(`    Note: ${term.notes}`);
+    }
+  }
+  lines.push("");
+  lines.push("Terms that should NEVER be translated (keep as-is):");
+  lines.push(`  ${TRANSLATION_RULES.neverTranslate.join(", ")}`);
+  lines.push("");
+  lines.push("Official terms (keep in original language, use quotes if needed):");
+  for (const term of TRANSLATION_RULES.officialTerms) {
+    lines.push(`  - "${term.term}" (${term.language})`);
+    if (term.notes) {
+      lines.push(`    Note: ${term.notes}`);
+    }
+  }
+  lines.push("");
+  lines.push("Button/CTA text translations:");
+  for (const cta of TRANSLATION_RULES.ctaTranslations) {
+    lines.push(`  - "${cta.dutch}" (Dutch) = "${cta.english}" (English)`);
+  }
+  lines.push("");
+  lines.push("CIIIC-specific terms:");
+  for (const term of TRANSLATION_RULES.ciiicSpecifics) {
+    lines.push(`  - "${term.dutch}" (Dutch) = "${term.english}" (English)`);
+  }
+  lines.push("");
+  lines.push("Newsletter-specific phrases:");
+  for (const phrase of TRANSLATION_RULES.newsletterPhrases) {
+    lines.push(`  - "${phrase.dutch}" (Dutch) = "${phrase.english}" (English)`);
+  }
+  lines.push("");
+  lines.push("Personal names:");
+  lines.push("  - People's names must NEVER be translated");
+  lines.push('  - Example: "Jan de Vries" stays "Jan de Vries", NOT "John of Vries"');
+  lines.push("");
+  lines.push(
+    "GENERAL PRINCIPLE: It is acceptable and often preferable to leave some terms in their original language. Proper nouns, programme names, personal names, and official terminology should generally remain unchanged or use the official translation if one exists."
+  );
+  return lines.join("\n");
+}
+function getDutchGuidelines() {
+  return `
+DUTCH-SPECIFIC RULES:
+- Headlines and titles: Use sentence case only (first letter capitalised, rest lowercase)
+  Example: "Deze titel is goed" NOT "Deze Titel Is Goed"
+- Use informal Dutch: Always use "je/jij/jouw" instead of "u/uw"
+- Maintain a friendly but professional tone
+- When translating "Creative Industries Fund NL" \u2192 use "Stimuleringsfonds Creatieve Industrie"
+- "Immersive experiences" can stay in English or be translated to "immersieve ervaringen"
+- The word "call" (funding call) can remain "call" or be translated to "regeling"
+
+${generateTerminologyPrompt()}`;
+}
+function getEnglishGuidelines() {
+  return `
+ENGLISH-SPECIFIC RULES:
+- Use British English spellings (e.g., "colour" not "color", "organise" not "organize", "centre" not "center")
+- British vocabulary: "programme" (not "program" for non-computer contexts), "behaviour", "favour", etc.
+- Date format references should use British conventions where applicable
+- When translating "Stimuleringsfonds Creatieve Industrie" \u2192 use "Creative Industries Fund NL"
+
+${generateTerminologyPrompt()}`;
+}
+function getGuidelines(targetLanguage) {
+  return targetLanguage === "nl" ? getDutchGuidelines() : getEnglishGuidelines();
+}
+function translateFundingCall(name, targetLanguage) {
+  const sourceKey = targetLanguage === "en" ? "dutch" : "english";
+  const targetKey = targetLanguage === "en" ? "english" : "dutch";
+  const mapping = TRANSLATION_RULES.fundingCalls.find(
+    (call) => call[sourceKey].toLowerCase() === name.toLowerCase()
+  );
+  return mapping?.[targetKey];
+}
+function translateOrganisation(name, targetLanguage) {
+  const sourceKey = targetLanguage === "en" ? "dutch" : "english";
+  const targetKey = targetLanguage === "en" ? "english" : "dutch";
+  const mapping = TRANSLATION_RULES.organisations.find(
+    (org) => org[sourceKey].toLowerCase() === name.toLowerCase()
+  );
+  return mapping?.[targetKey];
+}
+function shouldNeverTranslate(term) {
+  return TRANSLATION_RULES.neverTranslate.some(
+    (t) => t.toLowerCase() === term.toLowerCase()
+  );
+}
+function generateMarkdownPrompt() {
+  const lines = [];
+  lines.push("# CIIIC Translation Rules");
+  lines.push("");
+  lines.push("Use these rules when translating content between Dutch and English for CIIIC.");
+  lines.push("");
+  lines.push("## Organisation Names");
+  lines.push("");
+  lines.push("| Dutch | English | Notes |");
+  lines.push("|-------|---------|-------|");
+  for (const org of TRANSLATION_RULES.organisations) {
+    lines.push(`| ${org.dutch} | ${org.english} | ${org.notes || ""} |`);
+  }
+  lines.push("");
+  lines.push("## Funding Call Translations");
+  lines.push("");
+  lines.push("Use these exact translations for funding call names:");
+  lines.push("");
+  lines.push("| Dutch | English | Notes |");
+  lines.push("|-------|---------|-------|");
+  for (const call of TRANSLATION_RULES.fundingCalls) {
+    const note = call.dutch === call.english ? "Same in both languages" : call.notes || "";
+    lines.push(`| ${call.dutch} | ${call.english} | ${note} |`);
+  }
+  lines.push("");
+  lines.push("## Button/CTA Text");
+  lines.push("");
+  lines.push("| Dutch | English |");
+  lines.push("|-------|---------|");
+  for (const cta of TRANSLATION_RULES.ctaTranslations) {
+    lines.push(`| ${cta.dutch} | ${cta.english} |`);
+  }
+  lines.push("");
+  lines.push("## CIIIC-Specific Terms");
+  lines.push("");
+  lines.push("| Dutch | English |");
+  lines.push("|-------|---------|");
+  for (const term of TRANSLATION_RULES.ciiicSpecifics) {
+    lines.push(`| ${term.dutch} | ${term.english} |`);
+  }
+  lines.push("");
+  lines.push("## Terminology");
+  lines.push("");
+  lines.push("These terms can be used interchangeably or have specific translations:");
+  lines.push("");
+  lines.push("| Dutch | English | Notes |");
+  lines.push("|-------|---------|-------|");
+  for (const term of TRANSLATION_RULES.terminology) {
+    const dutchStr = term.dutch.join(", ");
+    const englishStr = term.english.join(", ");
+    lines.push(`| ${dutchStr} | ${englishStr} | ${term.notes || ""} |`);
+  }
+  lines.push("");
+  lines.push("## Newsletter-Specific Phrases");
+  lines.push("");
+  lines.push("| Dutch | English |");
+  lines.push("|-------|---------|");
+  for (const phrase of TRANSLATION_RULES.newsletterPhrases) {
+    lines.push(`| ${phrase.dutch} | ${phrase.english} |`);
+  }
+  lines.push("");
+  lines.push("## Official Terms");
+  lines.push("");
+  lines.push("Keep these in their original language (use quotes if needed):");
+  lines.push("");
+  for (const term of TRANSLATION_RULES.officialTerms) {
+    lines.push(`- **${term.term}** (${term.language})${term.notes ? ` - ${term.notes}` : ""}`);
+  }
+  lines.push("");
+  lines.push("## Never Translate");
+  lines.push("");
+  lines.push("These terms should NEVER be translated - keep them exactly as-is:");
+  lines.push("");
+  lines.push("```");
+  lines.push(TRANSLATION_RULES.neverTranslate.join(", "));
+  lines.push("```");
+  lines.push("");
+  lines.push("## General Rules");
+  lines.push("");
+  lines.push("### Personal Names");
+  lines.push("- People's names must NEVER be translated");
+  lines.push('- Example: "Jan de Vries" stays "Jan de Vries", NOT "John of Vries"');
+  lines.push("");
+  lines.push("### Dutch-Specific");
+  lines.push("- Headlines and titles: Use sentence case only (first letter capitalised, rest lowercase)");
+  lines.push('- Use informal Dutch: Always use "je/jij/jouw" instead of "u/uw"');
+  lines.push("- Maintain a friendly but professional tone");
+  lines.push("");
+  lines.push("### English-Specific");
+  lines.push("- Use British English spellings (colour, organise, centre)");
+  lines.push('- British vocabulary: "programme" (not "program"), "behaviour", "favour"');
+  lines.push("");
+  lines.push("### General Principle");
+  lines.push("It is acceptable and often preferable to leave some terms in their original language. Proper nouns, programme names, personal names, and official terminology should generally remain unchanged or use the official translation if one exists.");
+  lines.push("");
+  return lines.join("\n");
+}
+export {
+  TRANSLATION_RULES,
+  generateMarkdownPrompt,
+  generateTerminologyPrompt,
+  getDutchGuidelines,
+  getEnglishGuidelines,
+  getGuidelines,
+  shouldNeverTranslate,
+  translateFundingCall,
+  translateOrganisation
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "ciiic-translation-rules",
+  "version": "1.0.0",
+  "description": "Translation rules and terminology for CIIIC content (English/Dutch)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "TRANSLATION_PROMPT.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "generate-prompt": "npx tsx scripts/generate-prompt.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "translation",
+    "i18n",
+    "dutch",
+    "english",
+    "ciiic",
+    "localization"
+  ],
+  "author": "CIIIC",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ciiic/translation-rules.git"
+  }
+}