moracarta 2.1.0

package/src/commands/setup.js

@@ -0,0 +1,257 @@
+import {
+    select,
+    input,
+    confirm
+} from "@inquirer/prompts";
+import { writeFile, mkdir, cp, readFile  } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PACKAGE_ROOT = resolve(__dirname, "..", "..");
+
+/** TODO
+const LANGUAGE = await select({
+    message: "What is the main language of the application?",
+    choices: [
+        { name: "English", value: "en" },
+        { name: "Português (Brasil)", value: "pt-BR" }
+    ]
+});
+*/
+const LANGUAGE = "en";
+
+const PROJECT_NAME = await input({
+    message: "What should your project be called? (Cloudflare project name, do not use 'moracarta')",
+    default: "romantic-gift",
+});
+
+const TITLE = await input({
+    message: "Enter the title of the application:",
+    default: "Letters to my love"
+});
+
+const FONT = await select({
+    message: "What font would you like to use?",
+    choices: [
+        { name: "Handwritten", value: "handwritten" },
+        { name: "Classic", value: "classic" },
+        { name: "Modern", value: "modern" }
+    ]
+});
+
+const TOP_MESSAGES = {
+    top_1: "Every letter here holds a piece of everything I feel for you.",
+    top_2: "If my love could fit into words, these would just be the beginning.",
+    top_3: "Open slowly — every envelope has a little piece of me inside.",
+    top_4: "I didn't write letters. I wrote promises.",
+    top_5: "Made by hand, kept in my heart — for you."
+};
+
+const TOP_CHOICE = await select({
+    message: "Choose the message at the top of the main page:",
+    choices: [
+        {
+            name: "Insert custom text",
+            value: "custom"
+        },
+        ...Object.entries(TOP_MESSAGES).map(([value, name]) => ({
+            name,
+            value
+        }))
+    ]
+});
+
+const TEXT_TOP = TOP_CHOICE === "custom"
+    ? await input({
+        message: "Enter your custom message:"
+    })
+    : TOP_MESSAGES[TOP_CHOICE];
+
+const BOTTOM_MESSAGES = {
+    bottom_1: "If I could choose again, I'd choose you in every version of my life. ♡",
+    bottom_2: "This is only a fraction of what I feel. I show you the rest every day. ♡",
+    bottom_3: "Thank you for being the reason for so many letters still to come. ♡",
+    bottom_4: "I love you in prose, in silence, and in every line I wrote here. ♡",
+    bottom_5: "End of the letters, not of the love. That one keeps going every day. ♡"
+};
+
+const BOTTOM_CHOICE = await select({
+    message: "Choose the message at the bottom of the main page:",
+    choices: [
+        {
+            name: "Insert custom text",
+            value: "custom"
+        },
+        ...Object.entries(BOTTOM_MESSAGES).map(([value, name]) => ({
+            name,
+            value
+        }))
+    ]
+});
+
+const TEXT_BOTTOM = BOTTOM_CHOICE === "custom"
+    ? await input({
+        message: "Enter your custom message:"
+    })
+    : BOTTOM_MESSAGES[BOTTOM_CHOICE];
+
+const FIRST_NAME = await input({
+    message: "Enter your first name: "
+});
+
+const YOUR_NAME = "~ "+FIRST_NAME+" ♡"; 
+
+const RECIPIENT_NAME = await input({
+    message: "What is their name?"
+});
+
+const DEFAULT_CLOSED_LETTER_TEXT_TOP_LINE =
+    `❤️ To ${RECIPIENT_NAME} ❤️`;
+
+const DEFAULT_CLOSED_LETTER_TEXT_BOTTOM_LINE =
+    "❤️ I love you ❤️";
+
+const EDIT_ENVELOPE_TEXT = await confirm({
+    message: "Would you like to customize the envelope text?",
+    default: false
+});
+
+let CLOSED_LETTER_TEXT_TOP_LINE = DEFAULT_CLOSED_LETTER_TEXT_TOP_LINE;
+let CLOSED_LETTER_TEXT_BOTTOM_LINE = DEFAULT_CLOSED_LETTER_TEXT_BOTTOM_LINE;
+
+if (EDIT_ENVELOPE_TEXT) {
+    CLOSED_LETTER_TEXT_TOP_LINE = await input({
+        message: "Top line of the closed envelope (press TAB to edit):",
+        default: DEFAULT_CLOSED_LETTER_TEXT_TOP_LINE
+    });
+
+    CLOSED_LETTER_TEXT_BOTTOM_LINE = await input({
+        message: "Bottom line of the closed envelope (press TAB to edit):",
+        default: DEFAULT_CLOSED_LETTER_TEXT_BOTTOM_LINE
+    });
+}
+
+const config = `/**
+ * This file was generated automatically by Moracarta setup.
+ */
+
+const LANGUAGE = ${JSON.stringify(LANGUAGE)};
+
+const PROJECT_NAME = ${JSON.stringify(PROJECT_NAME)};
+const TITLE = ${JSON.stringify(TITLE)};
+
+const FONT = ${JSON.stringify(FONT)};
+
+const TEXT_TOP = ${JSON.stringify(TEXT_TOP)};
+const TEXT_BOTTOM = ${JSON.stringify(TEXT_BOTTOM)};
+const YOUR_NAME = ${JSON.stringify(YOUR_NAME)};
+
+const CLOSED_LETTER_TEXT_TOP_LINE =
+    ${JSON.stringify(CLOSED_LETTER_TEXT_TOP_LINE)};
+
+const CLOSED_LETTER_TEXT_BOTTOM_LINE =
+    ${JSON.stringify(CLOSED_LETTER_TEXT_BOTTOM_LINE)};
+
+const globalVariables = {
+    LANGUAGE,
+    PROJECT_NAME,
+    TITLE,
+    YOUR_NAME,
+    FONT,
+    TEXT_TOP,
+    TEXT_BOTTOM,
+    CLOSED_LETTER_TEXT_TOP_LINE,
+    CLOSED_LETTER_TEXT_BOTTOM_LINE
+};
+
+export default globalVariables;
+`;
+
+const configPath = resolve(
+    process.cwd(),
+    "src",
+    "config",
+    "globalVariables.js"
+);
+
+await mkdir(dirname(configPath), { recursive: true });
+await writeFile(configPath, config, "utf8");
+
+/**
+ * Files that make up the actual site. These get copied out of the
+ * installed package and into the user's own project so `dev`/`build`
+ * run against a real local copy — never against node_modules.
+ */
+const TEMPLATE_ENTRIES = [
+    "index.html",
+    "vite.config.mjs",
+    "public",
+    "src/config/fonts.js",
+    "src/data/letters.example.js",
+    "src/data/lettersLoader.js",
+    "src/i18n",
+    "src/scripts",
+    "src/services",
+    "src/styles",
+    "src/views"
+];
+
+async function copyTemplateFiles() {
+    // Running the CLI from inside the moracarta source repo itself
+    // (e.g. via `npm run setup` while developing moracarta) — the
+    // "package" and the "project" are the same folder, nothing to copy.
+    if (resolve(PACKAGE_ROOT) === resolve(process.cwd())) {
+        return;
+    }
+
+    console.log("\nCopying project files...");
+
+    for (const entry of TEMPLATE_ENTRIES) {
+        const source = resolve(PACKAGE_ROOT, entry);
+        const destination = resolve(process.cwd(), entry);
+
+        await mkdir(dirname(destination), { recursive: true });
+        await cp(source, destination, { recursive: true });
+    }
+
+    console.log("✓ Project files copied.");
+}
+
+async function ensureModuleType() {
+    const userPackageJsonPath = resolve(process.cwd(), "package.json");
+
+    let userPackageJson;
+
+    try {
+        userPackageJson = JSON.parse(
+            await readFile(userPackageJsonPath, "utf8")
+        );
+    } catch (error) {
+        if (error.code === "ENOENT") {
+            return;
+        }
+
+        throw error;
+    }
+
+    if (userPackageJson.type === "module") {
+        return;
+    }
+
+    userPackageJson.type = "module";
+
+    await writeFile(
+        userPackageJsonPath,
+        JSON.stringify(userPackageJson, null, 2) + "\n",
+        "utf8"
+    );
+}
+
+await copyTemplateFiles();
+await ensureModuleType();
+
+console.log("\n❤️ Moracarta setup complete!");
+console.log(`Configuration saved to: ${configPath}`);
+console.log("Run moracarta dev to test the application");

package/src/config/fonts.js

@@ -0,0 +1,7 @@
+const fonts = {
+    classic: "'Lora', Georgia, serif",
+    handwritten: "'Cormorant Garamond', serif",
+    modern: "'Montserrat', Arial, sans-serif"
+};
+
+export default fonts;

package/src/data/letters.example.js

@@ -0,0 +1,28 @@
+export const letters = [
+  {
+    id: 1,
+    date: 'Aug 28, 2026',
+    title: 'Custom Letter Title 1',
+    content: `My Dearest Mary Jane,
+    As I sit down to write these words, I am thinking of you and how grateful I am for everything we experience together. Life moves quickly, but whenever I pause to reflect on what brings me the most joy, you are always at the top of my mind.
+    You bring so much inspiration and comfort into my life. Whether we are sharing long conversations or simply enjoying quiet moments together, being with you feels natural and right. Your support and kindness mean more to me than I can easily put into words.
+    I wanted to remind you today of how deeply appreciated and loved you are. No matter where life takes us, know that you hold a very special place in my heart.
+
+Yours always,
+Peter Parker`
+  },
+  {
+    id: 2,
+    date: 'Aug 28, 2026',
+    title: 'Custom Letter Title 2',
+    content: `Dearest Mary Jane,
+    
+    I hope this letter finds you well. I wanted to take a quiet moment today to write to you and express just how much you mean to me. Even in the midst of everyday life, my thoughts frequently return to you and the wonderful moments we share.
+    Your presence brings warmth, kindness, and light into my world. Every memory with you is something I truly cherish, and I am constantly reminded of how fortunate I am to have you in my life. You have a way of making ordinary days feel special just by being yourself.
+    Thank you for your affection, your understanding, and all the happiness you bring into my life. I look forward to creating many more beautiful memories together in the time ahead.
+
+
+With all my love,
+Peter Parker`
+  }
+];

package/src/data/lettersLoader.js

@@ -0,0 +1,7 @@
+const modules = import.meta.glob("./letters*.js", {
+  eager: true,
+  import: "letters",
+});
+
+export const letters =
+  modules["./letters.js"] ?? modules["./letters.example.js"];

package/src/i18n/de.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "Zum Öffnen tippen",
+    RETURN: "Zurück",
+    PREVIOUS: "Vorherige",
+    NEXT: "Nächste",
+    OF: "von",
+    LETTER_NOT_FOUND: "Brief nicht gefunden."
+}

package/src/i18n/en.js

@@ -0,0 +1,8 @@
+export default{
+    TAP_TO_OPEN: "Tap to open",
+    RETURN: "Return",
+    PREVIOUS: "Previous",
+    NEXT: "Next",
+    OF: "of",
+    LETTER_NOT_FOUND: "Letter not found."
+}

package/src/i18n/es.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "Toca para abrir",
+    RETURN: "Volver",
+    PREVIOUS: "Anterior",
+    NEXT: "Siguiente",
+    OF: "de",
+    LETTER_NOT_FOUND: "Carta no encontrada."
+}

package/src/i18n/fr.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "Touchez pour ouvrir",
+    RETURN: "Retour",
+    PREVIOUS: "Précédente",
+    NEXT: "Suivante",
+    OF: "sur",
+    LETTER_NOT_FOUND: "Lettre introuvable."
+}

package/src/i18n/it.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "Tocca per aprire",
+    RETURN: "Indietro",
+    PREVIOUS: "Precedente",
+    NEXT: "Successiva",
+    OF: "di",
+    LETTER_NOT_FOUND: "Lettera non trovata."
+}

package/src/i18n/ja.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "タップして開く",
+    RETURN: "戻る",
+    PREVIOUS: "前へ",
+    NEXT: "次へ",
+    OF: "の",
+    LETTER_NOT_FOUND: "手紙が見つかりません。"
+}

package/src/i18n/ko.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "탭하여 열기",
+    RETURN: "돌아가기",
+    PREVIOUS: "이전",
+    NEXT: "다음",
+    OF: "중",
+    LETTER_NOT_FOUND: "편지를 찾을 수 없습니다."
+}

package/src/i18n/pt-BR.js

@@ -0,0 +1,8 @@
+export default{
+    TAP_TO_OPEN: "Toque para abrir",
+    RETURN: "Voltar",
+    PREVIOUS: "Anterior",
+    NEXT: "Próxima",
+    OF: "de",
+    LETTER_NOT_FOUND: "Carta não encontrada."
+}

package/src/i18n/ru.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "Нажмите, чтобы открыть",
+    RETURN: "Назад",
+    PREVIOUS: "Предыдущая",
+    NEXT: "Следующая",
+    OF: "из",
+    LETTER_NOT_FOUND: "Письмо не найдено."
+}

package/src/i18n/zh.js

@@ -0,0 +1,8 @@
+export default {
+    TAP_TO_OPEN: "点击打开",
+    RETURN: "返回",
+    PREVIOUS: "上一封",
+    NEXT: "下一封",
+    OF: "共",
+    LETTER_NOT_FOUND: "未找到信件。"
+}

package/src/scripts/data.variable.js

@@ -0,0 +1,24 @@
+import globalVariables from '../config/globalVariables.js';
+import fonts from '../config/fonts.js';
+
+document.documentElement.style.setProperty(
+    '--main-font',
+    fonts[globalVariables.FONT] || fonts.handwritten
+);
+
+// Data variables are injected from `src/config/globalVariables.js` into
+// HTML elements using the `data-variable` attribute.
+// HTML entities are preserved when the value contains markup characters.
+document.querySelectorAll("[data-variable]").forEach(element => {
+    const value = globalVariables[element.dataset.variable];
+
+    if (typeof value === 'string' && (value.includes('&') || value.includes('<') || value.includes('>'))) {
+        element.innerHTML = value;
+    } else {
+        element.textContent = value;
+    }
+});
+
+document.querySelectorAll("[data-variable-src]").forEach(element => {
+    element.src = globalVariables[element.dataset.variableSrc];
+});

package/src/scripts/i18n.js

@@ -0,0 +1,67 @@
+import globalVariables from "../config/globalVariables.js";
+
+import en from "../i18n/en.js";
+import ptbr from "../i18n/pt-BR.js";
+import es from "../i18n/es.js";
+import fr from "../i18n/fr.js";
+import de from "../i18n/de.js";
+import it from "../i18n/it.js";
+import ja from "../i18n/ja.js";
+import ko from "../i18n/ko.js";
+import zh from "../i18n/zh.js";
+import ru from "../i18n/ru.js";
+
+// Language files are selected by the configured LANGUAGE value.
+// Missing translation keys fall back to English, then to the key name.
+const translations = {
+    en,
+    "pt-BR": ptbr,
+    es,
+    fr,
+    de,
+    it,
+    ja,
+    ko,
+    zh,
+    ru
+};
+
+const getCurrentLanguage = () => globalVariables?.LANGUAGE || "en";
+
+export const getTranslation = (key, ...args) => {
+    const language = translations[getCurrentLanguage()] || translations.en;
+
+    const translation =
+        language?.[key] ??
+        translations.en?.[key] ??
+        key;
+
+    // Support translated functions such as PROGRESS(current, total)
+    return typeof translation === "function"
+        ? translation(...args)
+        : translation;
+};
+
+export const translateElement = (element) => {
+    const key = element.dataset.i18n;
+
+    if (key) {
+        element.textContent = getTranslation(key);
+    }
+};
+
+document
+    .querySelectorAll("[data-i18n]")
+    .forEach(translateElement);
+
+export const refreshTranslations = () => {
+    document
+        .querySelectorAll("[data-i18n]")
+        .forEach(translateElement);
+};
+
+window.i18n = {
+    getTranslation,
+    translateElement,
+    refreshTranslations
+};