@jjlmoya/utils-performing-arts 1.1.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,40 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Sync package.json version from tag
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          if [ "$VERSION" != "$CURRENT_VERSION" ]; then
+            npm version $VERSION --no-git-tag-version
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git add package.json
+            git commit -m "chore: bump version to $VERSION [skip ci]"
+            git push origin HEAD:master
+          fi
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.gitignore

@@ -0,0 +1,6 @@
+dist/
+node_modules/
+.env
+.astro/
+.gemini/
+.claude/

package/.stylelintrc.json

@@ -0,0 +1,98 @@
+{
+    "extends": [
+        "stylelint-config-standard"
+    ],
+    "overrides": [
+        {
+            "files": [
+                "**/*.astro"
+            ],
+            "customSyntax": "postcss-html"
+        },
+        {
+            "files": [
+                "src/tool/**/*.css",
+                "src/tool/**/*.astro",
+                "src/pages/**/*.astro"
+            ],
+            "rules": {
+                "color-named": null,
+                "property-no-vendor-prefix": null,
+                "selector-pseudo-element-colon-notation": null,
+                "declaration-block-no-redundant-longhand-properties": null,
+                "rule-empty-line-before": null,
+                "import-notation": null,
+                "block-no-empty": null
+            }
+        },
+        {
+            "files": [
+                "src/layouts/**/*.astro"
+            ],
+            "rules": {
+                "property-disallowed-list": null
+            }
+        }
+    ],
+    "plugins": [
+        "stylelint-declaration-strict-value"
+    ],
+    "rules": {
+        "scale-unlimited/declaration-strict-value": [
+            [
+                "color",
+                "fill",
+                "stroke"
+            ],
+            {
+                "ignoreValues": [
+                    "transparent",
+                    "none",
+                    "inherit",
+                    "currentColor",
+                    "initial"
+                ]
+            }
+        ],
+        "color-no-invalid-hex": true,
+        "shorthand-property-no-redundant-values": true,
+        "declaration-block-no-duplicate-properties": true,
+        "no-duplicate-selectors": true,
+        "color-named": "never",
+        "unit-allowed-list": [
+            "px",
+            "rem",
+            "em",
+            "%",
+            "vw",
+            "vh",
+            "svh",
+            "svw",
+            "fr",
+            "deg",
+            "s",
+            "ms",
+            "ch"
+        ],
+        "declaration-no-important": true,
+        "alpha-value-notation": "number",
+        "comment-empty-line-before": null,
+        "no-descending-specificity": null,
+        "selector-pseudo-class-no-unknown": [
+            true,
+            {
+                "ignorePseudoClasses": [
+                    "global",
+                    "local"
+                ]
+            }
+        ],
+        "media-feature-range-notation": null,
+        "color-function-notation": "legacy",
+        "color-function-alias-notation": null,
+        "custom-property-pattern": null,
+        "property-disallowed-list": [
+            "font-family"
+        ]
+    }
+}

package/astro.config.mjs

@@ -0,0 +1,19 @@
+import { defineConfig } from "astro/config";
+import icon from "astro-icon";
+
+export default defineConfig({
+    integrations: [icon()],
+    server: {
+        port: 3037,
+        host: true
+    },
+    vite: {
+        server: {
+            watch: {
+                usePolling: true,
+                interval: 1000,
+            }
+        }
+    }
+});
+

package/eslint.config.js

@@ -0,0 +1,201 @@
+import eslintPluginAstro from "eslint-plugin-astro";
+import tseslint from "typescript-eslint";
+import noComments from "eslint-plugin-no-comments";
+
+const customCommentsPlugin = {
+    rules: {
+        "no-html-comments": {
+            meta: { type: "layout", fixable: "whitespace" },
+            create(context) {
+                return {
+                    Program() {
+                        const sourceCode = context.sourceCode;
+                        const text = sourceCode.getText();
+                        const regex = new RegExp("<!--[\\s\\S]*?-->", "g");
+                        let match;
+                        while ((match = regex.exec(text)) !== null) {
+                            context.report({
+                                loc: sourceCode.getLocFromIndex(match.index),
+                                message: "HTML comments are forbidden.",
+                                fix(fixer) {
+                                    return fixer.removeRange([match.index, match.index + match[0].length]);
+                                },
+                            });
+                        }
+                    },
+                };
+            },
+        },
+        "no-css-comments": {
+            meta: { type: "layout", fixable: "whitespace" },
+            create(context) {
+                return {
+                    Program() {
+                        const sourceCode = context.sourceCode;
+                        const text = sourceCode.getText();
+                        const regex = new RegExp("/\\*[\\s\\S]*?\\*/", "g");
+                        let match;
+                        while ((match = regex.exec(text)) !== null) {
+                            context.report({
+                                loc: sourceCode.getLocFromIndex(match.index),
+                                message: "CSS/Block comments are forbidden.",
+                                fix(fixer) {
+                                    return fixer.removeRange([match.index, match.index + match[0].length]);
+                                },
+                            });
+                        }
+                    },
+                };
+            },
+        },
+        "no-emojis": {
+            meta: { type: "layout", fixable: false },
+            create(context) {
+                return {
+                    Program() {
+                        const sourceCode = context.sourceCode;
+                        const text = sourceCode.getText();
+                        const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{27BF}]|[\u{1F680}-\u{1F6FF}]/gu;
+                        let match;
+                        while ((match = emojiRegex.exec(text)) !== null) {
+                            context.report({
+                                loc: sourceCode.getLocFromIndex(match.index),
+                                message: "Emojis are not allowed in code.",
+                            });
+                        }
+                    },
+                };
+            },
+        },
+        "single-font-load": {
+            meta: { type: "suggestion", fixable: false },
+            create(context) {
+                return {
+                    Program() {
+                        const sourceCode = context.sourceCode;
+                        const filename = context.filename;
+                        const isPreviewLayout = filename.includes("PreviewLayout.astro");
+                        const text = sourceCode.getText();
+                        const fontPatterns = [
+                            /fonts\.googleapis\.com/g,
+                            /@font-face\s*\{/g,
+                            /family:\s*['"](Inter|inter)['"]/g,
+                        ];
+                        if (!isPreviewLayout) {
+                            fontPatterns.forEach((pattern) => {
+                                let match;
+                                while ((match = pattern.exec(text)) !== null) {
+                                    context.report({
+                                        loc: sourceCode.getLocFromIndex(match.index),
+                                        message: "Fonts must be loaded only in PreviewLayout.astro. Do not declare fonts in other files.",
+                                    });
+                                }
+                            });
+                        }
+                    },
+                };
+            },
+        },
+    },
+};
+
+export default [
+    {
+        ignores: ["**/dist/", "**/node_modules/", ".astro/", "**/.astro/**", "**/public/**"],
+    },
+    ...tseslint.configs.recommended,
+    ...eslintPluginAstro.configs["flat/recommended"],
+
+    {
+        files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.mjs", "**/*.astro"],
+        plugins: { "no-comments": noComments, "custom": customCommentsPlugin },
+        rules: {
+            "custom/no-emojis": "error",
+            "custom/single-font-load": "error",
+            "no-comments/disallowComments": "error",
+            "@typescript-eslint/no-explicit-any": "error",
+            "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+            "@typescript-eslint/consistent-type-imports": "error",
+
+            "complexity": ["error", { max: 8 }],
+            "max-lines": ["error", { max: 250, skipBlankLines: true, skipComments: true }],
+            "max-lines-per-function": ["error", { max: 30, skipBlankLines: true, skipComments: true }],
+            "max-depth": ["error", 4],
+            "max-params": ["error", 4],
+            "no-nested-ternary": "error",
+            "no-unneeded-ternary": "error",
+        },
+    },
+
+    {
+        files: ["**/*.astro", "**/*.html"],
+        plugins: { custom: customCommentsPlugin },
+        rules: { "custom/no-html-comments": "error" },
+    },
+
+    {
+        files: ["**/*.astro"],
+        plugins: { custom: customCommentsPlugin },
+        rules: {
+            "custom/no-css-comments": "error",
+            "custom/single-font-load": "error",
+            "max-lines": ["error", { max: 250, skipBlankLines: true, skipComments: true }],
+        },
+    },
+
+    {
+        files: ["**/SEORenderer.astro"],
+        rules: {
+            "max-lines-per-function": "off",
+            "complexity": "off",
+        },
+    },
+    {
+        files: ["**/i18n/*.ts"],
+        rules: {
+            "max-lines": "off",
+        },
+    },
+    {
+        files: ["**/pages/**/*.astro"],
+        rules: {
+            "max-lines-per-function": ["error", { max: 50, skipBlankLines: true, skipComments: true }],
+            "complexity": "off",
+            "no-comments/disallowComments": "off",
+        },
+    },
+    {
+        files: ["**/tests/**/*.ts", "**/*.test.ts"],
+        rules: {
+            "@typescript-eslint/no-explicit-any": "off",
+            "max-lines-per-function": "off",
+            "max-lines": "off",
+        },
+    },
+    {
+        files: ["**/*seo.astro"],
+        rules: {
+            "max-lines-per-function": "off",
+            "complexity": "off",
+            "@typescript-eslint/no-explicit-any": "off",
+        },
+    },
+    {
+        files: ["**/i18n/**/*.ts", "**/app.ts"],
+        rules: {
+            "@typescript-eslint/no-explicit-any": "off",
+            "max-params": "off",
+            "max-lines": "off",
+            "max-lines-per-function": "off",
+        },
+    },
+    {
+        files: ["**/tool/**/component.astro"],
+        rules: {
+            "max-lines": "off",
+            "max-lines-per-function": "off",
+            "complexity": "off",
+        },
+    },
+];
+

package/package.json

@@ -0,0 +1,79 @@
+{
+    "name": "@jjlmoya/utils-performing-arts",
+    "version": "1.1.0",
+    "type": "module",
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "exports": {
+        ".": "./src/index.ts",
+        "./data": "./src/data.ts",
+        "./entries": "./src/entries.ts",
+        "./runtime/*": "./src/tool/*/index.ts",
+        "./category-seo": "./src/category/PerformingArtsCategorySEO.astro"
+    },
+    "files": [
+        ".github",
+        ".gitignore",
+        ".stylelintrc.json",
+        "astro.config.mjs",
+        "eslint.config.js",
+        "package.json",
+        "package-lock.json",
+        "prompts",
+        "scripts",
+        "src",
+        "tsconfig.json",
+        "vitest.config.ts"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "dev": "astro dev --host",
+        "start": "astro dev",
+        "build": "astro build",
+        "preview": "astro preview",
+        "astro": "astro",
+        "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
+        "check": "astro check",
+        "type-check": "astro check",
+        "test": "vitest run --reporter=verbose --testTimeout=30000",
+        "preversion": "npm run lint && npm run test && npm run build",
+        "postversion": "git push && git push --tags",
+        "patch": "npm version patch",
+        "minor": "npm version minor",
+        "major": "npm version major",
+        "postinstall": "node scripts/postinstall.mjs"
+    },
+    "lint-staged": {
+        "*.{ts,tsx,astro}": [
+            "eslint --fix"
+        ]
+    },
+    "dependencies": {
+        "@iconify-json/mdi": "^1.2.3",
+        "@jjlmoya/prompagate": "^1.1.0",
+        "@jjlmoya/utils-shared": "1.2.0",
+        "@panzoom/panzoom": "^4.6.2",
+        "astro": "^6.1.2",
+        "astro-icon": "^1.1.0",
+        "html2canvas": "^1.4.1",
+        "interactjs": "^1.10.27"
+    },
+    "devDependencies": {
+        "@astrojs/check": "^0.9.8",
+        "eslint": "^9.39.4",
+        "eslint-plugin-astro": "^1.6.0",
+        "eslint-plugin-no-comments": "^1.1.10",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.4.0",
+        "postcss-html": "^1.8.1",
+        "schema-dts": "^1.1.2",
+        "stylelint": "^17.6.0",
+        "stylelint-config-standard": "^40.0.0",
+        "stylelint-declaration-strict-value": "^1.11.1",
+        "typescript": "^5.4.0",
+        "typescript-eslint": "^8.58.0",
+        "vitest": "^4.1.2"
+    }
+}

package/prompts/create_tool.md

@@ -0,0 +1,98 @@
+¡Hola! Qué buena base de partida. Lo que tienes aquí es una guía excelente, pero hiperfocalizada en herramientas de rol y dados (performing-arts).
+
+Para transformarla en una habilidad/guía genérica, lo que haremos será abstraer el dominio del juego y los dados, y sustituirlo por conceptos universales de desarrollo de software (como "núcleo de la aplicación", "métricas de negocio", "feedback visual de alto impacto" y "componentes estructurados").
+
+Aquí tienes la versión completamente genérica, modular y lista para aplicar a cualquier tipo de biblioteca de herramientas web.
+
+Creating Library Tools: Developer Skill & Workflow Guide
+Follow this guide to build new tools in the core utility library. This document outlines the technical standards, user experience (UX) requirements, SEO standards, and step-by-step translation workflow.
+
+Philosophy & Rigid Rules
+1. Code Quality & Formatting
+SOLID Principles: Keep components small, focused, and reusable. Business logic and UI components must be completely separated.
+
+NO Comments in Code: Do not write any comments (// or /* */) in TypeScript, framework components, CSS, or JSON files.
+
+NO Emojis: Do not use emojis in code, UI text, logs, titles, metadata, or translations.
+
+2. High-Dopamine User Experience
+Interactive Outcomes: Visual result banners must include detailed logical breakdowns displaying custom geometric badges or status indicators that match the exact category and context of the output.
+
+Epic Feedback Animations:
+
+Peak or optimal results must trigger an emphasis animation (e.g., scale-up rotation, bright dynamic border) and render a custom highlighting SVG symbol.
+
+Critical errors or minimal results must trigger a warning animation (e.g., shiver-drop sag, desaturated danger glow) and render a distinct alert SVG symbol.
+
+Click Particles: Spawn floating micro-feedback particles (e.g., value offsets, status triggers) at the exact click coordinates with text shadow glows and translation animations.
+
+Micro-Animations: All interactive elements (button presses, selectors, and adjustments) must trigger springy hover and active scale animations to maximize tactile responsiveness.
+
+3. Premium User-Facing SEO
+No Programming Content: Do not write code examples, programming explanations, or developer jargon in public SEO text. Focus entirely on user utility, core value proposition, and practical use cases.
+
+Rich Elements: Build information architectures using structured layouts (stats, table, tip, proscons, comparative, glossary, diagnostic).
+
+No Hyphens or Pipes in Titles: Page titles in SEO sections and metadata must never contain - or | separators.
+
+Workflow Steps
+Step 1: Core Implementation (English-First)
+Analyze existing library tools to understand registered paths, file structures, and shared core imports.
+
+Build the primary tool files in English following the architecture:
+
+src/tool/$TOOL_ID/index.ts (Core logic)
+
+src/tool/$TOOL_ID/entry.ts (Registration & metadata)
+
+src/tool/$TOOL_ID/component.[ext] (UI View)
+
+src/tool/$TOOL_ID/seo.[ext] (SEO & Marketing content)
+
+src/tool/$TOOL_ID/bibliography.ts (Data sources/References logic)
+
+src/tool/$TOOL_ID/bibliography.[ext] (Data sources view)
+
+src/tool/$TOOL_ID/i18n/en.ts (English dictionary)
+
+src/tool/$TOOL_ID/$TOOL_ID.css (Scoped styles)
+
+Map all i18n properties in the entry file to the English dictionary temporarily.
+
+Add the new tool entry to the central registration files (indexes, categories, and routing lists).
+
+Step 2: Component Refactoring & Clean Up
+Enforce strict style linting compliance: Do not use literal design values (hex, rgb, raw pixels) inside CSS properties; declare them as design tokens/CSS variables in the global root scope and read them via var().
+
+Keep functions under 30 lines and source code files under 250 lines to maintain maintainability.
+
+Step 3: Verification & QA
+Run linting to check for formatting, syntax, and comment violations:
+npm run lint
+
+Run unit tests to check core mathematical, parsing, or business logic:
+npm run test -- --testPathIgnorePatterns=i18n_coverage
+
+After this, ask for the user's feedback.
+
+Step 4: Multi-Language Translation
+Once the baseline English tool is validated by the user, translate the content to the supported production locales:
+
+Target Locales: de, es, fr, id, it, ja, ko, nl, pl, pt, ru, sv, tr, zh.
+
+Slug Localization Rules:
+
+For logographic script locales (ja, ko, zh), the URL slug must remain identical to the English slug.
+
+For all other locales, translate and fully localize the URL slug to its respective language.
+
+Separators Validation: Double check that no titles in the translated files contain - or |.
+
+Register the loaders for the new locales in the tool's entry configuration.
+
+Step 5: Final Verification
+Run the complete automated lint and test suites to verify all locales and configurations are fully compliant:
+
+npm run lint
+
+npm run test

package/prompts/i18n/de.md

@@ -0,0 +1,16 @@
+# Prompts-utsch (de)
+
+## Übersetzung
+
+Lokalisieren Sie den folgenden Inhalt ins Deutsche.
+
+Übersetzen Sie nicht: lokalisieren Sie. Das Ziel ist nicht, Wörter von einer Sprache in eine andere zu übertragen, sondern einen Text zu erstellen, der so klingt, als wäre er von Anfang an von einem echten Menschen auf Deutsch geschrieben worden. Ein gut lokalisierter Text lässt keine Spuren der Ausgangssprache erkennen.
+
+Schreiben Sie mit menschlicher Stimme: nah, klar und professionell. Vermeiden Sie Maschinensprache, erzwungene Konstruktionen und Sätze, die wie eine Bedienungsanleitung klingen. Wenn etwas auf Deutsch nicht natürlich fließt, formulieren Sie es um, bis es das tut.
+
+Einzuhaltende Richtlinien:
+
+- Passen Sie Ausdrücke, Metaphern und kulturelle Bezüge an das an, was in einem deutschsprachigen Kontext natürlich ankommen würde.
+- Verwenden Sie Fachbegriffe in ihrer im deutschsprachigen Raum gebräuchlichsten Form; wenn kein klares Äquivalent existiert, behalten Sie den Originalbegriff bei.
+- Respektieren Sie die Formatierung des Originals (Markdown, Listen, Überschriften).
+- Fügen Sie keine Informationen hinzu und lassen Sie keine Informationen gegenüber dem Original weg.

package/prompts/i18n/en.md

@@ -0,0 +1,16 @@
+# Prompts-glish (en)
+
+## Translation
+
+Localize the following content into English.
+
+Don't translate: localize. Your goal is not to carry words from one language to another, but to produce text that reads as if it were written in English by a real person from the start. A well-localized text leaves no trace of the source language.
+
+Write with a human voice: warm, clear, and professional. Avoid machine-like phrasing, stiff constructions, and anything that sounds like it came out of an instruction manual. If something doesn't flow naturally in English, rewrite it until it does.
+
+Guidelines to follow:
+
+- Adapt expressions, metaphors, and cultural references to what would resonate naturally in an English-speaking context.
+- Keep technical terms in their most widely recognized form in the English-speaking world; if no clear equivalent exists, retain the original term.
+- Respect the formatting of the original (markdown, lists, headings).
+- Do not add or omit any information from the original.

package/prompts/i18n/es.md

@@ -0,0 +1,16 @@
+# Prompts-pañol (es)
+
+## Traducción
+
+Localiza el siguiente contenido al español.
+
+No traduzcas: localiza. Tu objetivo no es trasladar palabras de un idioma a otro, sino que el resultado suene como si hubiera sido escrito originalmente en español por una persona real. Un texto bien localizado no tiene rastro del idioma de origen.
+
+Escribe con voz humana: cercana, clara y profesional. Evita el lenguaje de máquina, los giros forzados y las frases que suenan a manual de instrucciones. Si algo no fluye de forma natural en español, reformúlalo hasta que lo haga.
+
+Criterios que debes respetar:
+
+- Adapta expresiones, metáforas y referencias culturales a lo que resonaría de forma natural en un contexto hispanohablante.
+- Mantén los términos técnicos en su forma más reconocida en el ámbito hispanohablante; si no existe un equivalente claro, conserva el término original.
+- Respeta el formato del original (markdown, listas, encabezados).
+- No añadas ni omitas información respecto al original.

package/prompts/i18n/fr.md

@@ -0,0 +1,16 @@
+# Prompts-ançais (fr)
+
+## Traduction
+
+Localisez le contenu suivant en français.
+
+Ne traduisez pas : localisez. L'objectif n'est pas de transposer des mots d'une langue à l'autre, mais de produire un texte qui semble avoir été écrit directement en français par une personne réelle. Un texte bien localisé ne laisse aucune trace de la langue source.
+
+Écrivez avec une voix humaine : proche, claire et professionnelle. Évitez le langage machine, les tournures forcées et les phrases qui sonnent comme un manuel d'utilisation. Si quelque chose ne coule pas naturellement en français, reformulez-le jusqu'à ce que ce soit le cas.
+
+Critères à respecter :
+
+- Adaptez les expressions, les métaphores et les références culturelles à ce qui résonnerait naturellement dans un contexte francophone.
+- Conservez les termes techniques dans leur forme la plus reconnue dans le monde francophone ; s'il n'existe pas d'équivalent clair, gardez le terme original.
+- Respectez la mise en forme de l'original (markdown, listes, titres).
+- N'ajoutez ni ne supprimez aucune information par rapport à l'original.

package/prompts/i18n/id.md

@@ -0,0 +1,16 @@
+# Prompts-hasa Indonesia (id)
+
+## Terjemahan
+
+Lokalisasi konten berikut ke dalam Bahasa Indonesia.
+
+Jangan menerjemahkan: lokalisasi. Tujuannya bukan memindahkan kata dari satu bahasa ke bahasa lain, melainkan menghasilkan teks yang terasa seolah-olah ditulis langsung dalam Bahasa Indonesia oleh orang sungguhan. Teks yang dilokalisasi dengan baik tidak meninggalkan jejak bahasa sumbernya.
+
+Tulis dengan suara manusia: hangat, jelas, dan profesional. Hindari bahasa mesin, susunan kalimat yang dipaksakan, dan kalimat yang terdengar seperti buku panduan. Jika ada yang tidak mengalir secara alami dalam Bahasa Indonesia, tulis ulang hingga terasa alami.
+
+Panduan yang harus diikuti:
+
+- Sesuaikan ekspresi, metafora, dan referensi budaya agar beresonansi secara alami dalam konteks berbahasa Indonesia.
+- Gunakan istilah teknis dalam bentuk yang paling dikenal di dunia berbahasa Indonesia; jika tidak ada padanan yang jelas, pertahankan istilah aslinya.
+- Pertahankan format asli (markdown, daftar, judul).
+- Jangan menambahkan atau menghilangkan informasi apa pun dari aslinya.

package/prompts/i18n/it.md

@@ -0,0 +1,16 @@
+# Prompts-aliano (it)
+
+## Traduzione
+
+Localizza il seguente contenuto in italiano.
+
+Non tradurre: localizza. L'obiettivo non è trasferire parole da una lingua all'altra, ma produrre un testo che sembri scritto fin dall'inizio in italiano da una persona reale. Un testo ben localizzato non lascia traccia della lingua di partenza.
+
+Scrivi con voce umana: vicina, chiara e professionale. Evita il linguaggio da macchina, le costruzioni forzate e le frasi che suonano come un manuale di istruzioni. Se qualcosa non scorre in modo naturale in italiano, riformulalo finché non lo fa.
+
+Criteri da rispettare:
+
+- Adatta espressioni, metafore e riferimenti culturali a ciò che risuonerebbe in modo naturale in un contesto italofono.
+- Mantieni i termini tecnici nella forma più riconoscibile nel mondo italofono; se non esiste un equivalente chiaro, conserva il termine originale.
+- Rispetta la formattazione dell'originale (markdown, liste, intestazioni).
+- Non aggiungere né omettere informazioni rispetto all'originale.

package/prompts/i18n/ja.md

@@ -0,0 +1,16 @@
+# Prompts-語 (ja)
+
+## 翻訳
+
+以下のコンテンツを日本語にローカライズしてください。
+
+翻訳ではなく、ローカライズを行ってください。目標は言葉をある言語から別の言語に移すことではなく、最初から日本語を母語とする人が書いたかのように自然に読めるテキストを作ることです。質の高いローカライズされたテキストには、原文言語の痕跡が残りません。
+
+人間の声で書いてください：親しみやすく、明確で、プロフェッショナルに。機械的な表現、不自然な言い回し、マニュアルのように聞こえる文章は避けてください。日本語として自然に読めない部分があれば、自然になるまで言い換えてください。
+
+遵守すべきガイドライン：
+
+- 表現、比喩、文化的な参照を、日本語圏のコンテキストで自然に響くものに適応させてください。
+- 技術用語は日本語圏で最も広く認知されている形で使用し、明確な対応語がない場合は元の用語をそのまま使用してください。
+- 原文のフォーマット（マークダウン、リスト、見出し）を尊重してください。
+- 原文から情報を追加したり省略したりしないでください。