joys-fonts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 joys
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# Joys Fonts
+
+Joys Fonts is a modern platform and CLI utility designed to package and install Persian web fonts into Tailwind CSS projects (specifically targeting **Tailwind CSS v4+**). 
+
+Instead of manual setup or adding the entire font collection as a dependency, the Joys Fonts CLI allows you to download and configure only the specific fonts you need.
+
+---
+
+## Features
+
+- **Tailwind CSS v4+ Native**: Automatically updates your main CSS file, injecting `@import` statements and registering theme variables inside the Tailwind `@theme` block.
+- **Zero-Dependency CLI**: Written in native Node.js ES Modules. Extremely fast and lightweight.
+- **WOFF2 Optimized**: Only keeps modern, optimized WOFF2 font assets for maximum web performance.
+- **Supports Static & Variable Fonts**: Installs and maps font weights (including custom axes) appropriately.
+
+---
+
+## Installation & Usage
+
+You don't need to install this package. You can run the installer CLI in the root of your project using your preferred package manager:
+
+### npm
+```bash
+npx joys-fonts add <font-slug>
+```
+
+### pnpm
+```bash
+pnpm dlx joys-fonts add <font-slug>
+```
+
+### yarn
+```bash
+yarn dlx joys-fonts add <font-slug>
+```
+
+### bun
+```bash
+bunx joys-fonts add <font-slug>
+```
+
+For example, to install the `joys-iran-sans-x` font using pnpm:
+
+```bash
+pnpm dlx joys-fonts add joys-iran-sans-x
+```
+
+### Options
+
+The CLI can be run non-interactively using options for automation and CI/CD:
+
+```bash
+npx joys-fonts add <font-slug> [options]
+```
+
+- `-d, --dest <path>`: Specify the directory where the font files should be copied.
+- `-c, --css <path>`: Specify your project's global/Tailwind CSS stylesheet to update.
+- `-y, --yes`: Auto-confirm all prompts with default settings.
+
+---
+
+## How It Works
+
+When you run `npx joys-fonts add joys-iran-sans-x`, the CLI will:
+1. Copy the font's WOFF2 files and its stylesheet (`joys-iran-sans-x.css`) to your project (e.g., `./src/fonts/joys-iran-sans-x`).
+2. Inject the stylesheet `@import` at the top of your global CSS:
+   ```css
+   @import "./fonts/joys-iran-sans-x/joys-iran-sans-x.css";
+   ```
+3. Update your Tailwind CSS v4 `@theme` block to declare the corresponding CSS font-family variables:
+   ```css
+   @theme {
+     --font-iran-sans-x: "JoysIranSansX", sans-serif;
+     --font-iran-sans-x-fanum: "JoysIranSansXFaNum", sans-serif;
+     --font-iran-sans-x-noen: "JoysIranSansXNoEn", sans-serif;
+   }
+   ```
+4. Now, you can use standard Tailwind classes anywhere in your HTML or React code:
+   - `font-iran-sans-x` (Default Regular weight)
+   - `font-iran-sans-x-fanum` (Persian numbers version)
+   - `font-iran-sans-x-noen` (No English letters version)
+
+---
+
+## Available Fonts
+
+The following fonts are packaged and available for installation:
+
+- `joys-iran-sans-x`
+- `joys-iran-yekan-x`
+- `joys-kalameh`
+- `joys-morabba`
+- `joys-yekan-bakh`
+
+---
+
+## Contributing & Adding Fonts
+
+If you want to contribute, add new Persian fonts, or edit existing ones, please follow our step-by-step guidelines in [CONTRIBUTING.md](./CONTRIBUTING.md) to keep the repository clean and standardized.
+
+---
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+/**
+ * Joys Fonts Installer CLI
+ * Usage: 
+ *   npx joys-fonts [command] [options]
+ *   node bin/cli.js [command] [options]
+ * 
+ * Commands:
+ *   add <font-slug>  Install a font into your project
+ *   list, ls         List all available fonts
+ *   help, -h, --help Show help screen
+ * 
+ * Options:
+ *   -d, --dest <path>  Install destination directory
+ *   -c, --css <path>   Global CSS file path to update
+ *   -y, --yes          Auto-confirm with default options
+ */
+
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline/promises';
+import { stdin as input, stdout as output } from 'process';
+import { manifest, installFont, detectTailwindVersion } from '../src/index.js';
+
+// Parse command line arguments
+function parseArgs(args) {
+  const options = {
+    command: null,
+    slug: null,
+    dest: null,
+    css: null,
+    yes: false,
+    help: false
+  };
+
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--dest' || arg === '-d') {
+      options.dest = args[++i];
+    } else if (arg === '--css' || arg === '-c') {
+      options.css = args[++i];
+    } else if (arg === '--yes' || arg === '-y') {
+      options.yes = true;
+    } else if (arg === '--help' || arg === '-h' || arg === 'help') {
+      options.help = true;
+    } else {
+      positionals.push(arg);
+    }
+  }
+
+  if (options.help) {
+    options.command = 'help';
+  } else if (positionals[0] === 'list' || positionals[0] === 'ls') {
+    options.command = 'list';
+  } else if (positionals[0] === 'add') {
+    options.command = 'add';
+    options.slug = positionals[1] || null;
+  } else if (positionals[0]) {
+    options.command = 'add';
+    options.slug = positionals[0];
+  }
+
+  return options;
+}
+
+function printHelp() {
+  console.log(`
+\x1b[35m=======================================\x1b[0m
+\x1b[36m\x1b[1m       Joys Fonts Installer CLI\x1b[0m
+\x1b[35m=======================================\x1b[0m
+
+Usage:
+  npx joys-fonts [command] [options]
+
+Commands:
+  \x1b[32madd <font-slug>\x1b[0m  Install a specific font
+  \x1b[32mlist, ls\x1b[0m         List all available fonts
+  \x1b[32mhelp, -h, --help\x1b[0m Show this help screen
+
+Options:
+  \x1b[33m-d, --dest <path>\x1b[0m  Install destination directory
+  \x1b[33m-c, --css <path>\x1b[0m   Global CSS file path to update
+  \x1b[33m-y, --yes\x1b[0m          Auto-confirm with default options
+
+Examples:
+  npx joys-fonts add joys-iran-sans-x
+  pnpm dlx joys-fonts list
+  yarn dlx joys-fonts add joys-kalameh --yes
+`);
+}
+
+function printList() {
+  console.log('\n\x1b[36mAvailable fonts in Joys Fonts:\x1b[0m');
+  console.log('\x1b[90m---------------------------------------\x1b[0m');
+  manifest.forEach((f, idx) => {
+    const families = f.families.map(fa => fa.family).join(', ');
+    console.log(`  ${idx + 1}. \x1b[32m\x1b[1m${f.slug}\x1b[0m`);
+    console.log(`     Families: \x1b[37m${families}\x1b[0m`);
+    console.log(`     CSS Path: \x1b[90m${f.css}\x1b[0m`);
+    console.log('\x1b[90m---------------------------------------\x1b[0m');
+  });
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+
+  if (options.command === 'help') {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (options.command === 'list') {
+    printList();
+    process.exit(0);
+  }
+
+  let slug = options.slug;
+  const rl = readline.createInterface({ input, output });
+
+  // If no slug is specified, prompt interactively
+  if (!slug) {
+    console.log('\n\x1b[35m=======================================\x1b[0m');
+    console.log('\x1b[36m\x1b[1m       Joys Fonts Installer CLI\x1b[0m');
+    console.log('\x1b[35m=======================================\x1b[0m\n');
+    console.log('Available fonts:');
+    manifest.forEach((f, idx) => {
+      console.log(`  [${idx + 1}] \x1b[32m${f.slug}\x1b[0m (${f.families.map(fa => fa.family).join(', ')})`);
+    });
+    
+    const choice = await rl.question('\nSelect a font number or type slug (e.g. joys-kalameh): ');
+    const idxChoice = parseInt(choice, 10);
+    let selected = null;
+    
+    if (!isNaN(idxChoice) && idxChoice >= 1 && idxChoice <= manifest.length) {
+      selected = manifest[idxChoice - 1];
+    } else {
+      const cleanChoice = choice.trim();
+      selected = manifest.find(f => f.slug === cleanChoice || f.slug === `joys-${cleanChoice}`);
+    }
+
+    if (!selected) {
+      console.error('\x1b[31m❌ Invalid selection.\x1b[0m');
+      rl.close();
+      process.exit(1);
+    }
+    slug = selected.slug;
+  }
+
+  const fontEntry = manifest.find(f => f.slug === slug);
+  if (!fontEntry) {
+    console.error(`\x1b[31m❌ Font slug "${slug}" not found in manifest.\x1b[0m`);
+    console.log(`Run \x1b[32mnpx joys-fonts list\x1b[0m to see all available fonts.`);
+    rl.close();
+    process.exit(1);
+  }
+
+  console.log(`\nSelected font: \x1b[36m${fontEntry.slug}\x1b[0m`);
+
+  // Determine default destination
+  let defaultDest = `./fonts/${slug}`;
+  if (fs.existsSync('src') && fs.statSync('src').isDirectory()) {
+    defaultDest = `./src/fonts/${slug}`;
+  } else if (fs.existsSync('app') && fs.statSync('app').isDirectory()) {
+    defaultDest = `./app/fonts/${slug}`;
+  }
+
+  let chosenDest = '';
+  if (options.dest) {
+    chosenDest = options.dest;
+  } else if (options.yes) {
+    chosenDest = defaultDest;
+  } else {
+    const destPathInput = await rl.question(`Install destination [\x1b[32m${defaultDest}\x1b[0m]: `);
+    chosenDest = destPathInput.trim() || defaultDest;
+  }
+  const destPath = path.resolve(chosenDest);
+
+  // Detect main CSS file
+  const commonCssPaths = [
+    'src/index.css',
+    'src/app.css',
+    'src/global.css',
+    'src/main.css',
+    'app/globals.css',
+    'app/global.css',
+    'index.css',
+    'global.css'
+  ];
+  let defaultCss = '';
+  for (const p of commonCssPaths) {
+    if (fs.existsSync(p)) {
+      defaultCss = p;
+      break;
+    }
+  }
+
+  let chosenCss = '';
+  if (options.css) {
+    chosenCss = options.css;
+  } else if (options.yes) {
+    chosenCss = defaultCss;
+  } else {
+    const cssPathInput = await rl.question(`Tailwind/Global CSS file path to update${defaultCss ? ` [\x1b[32m${defaultCss}\x1b[0m]` : ''} (press Enter to skip): `);
+    chosenCss = cssPathInput.trim() || defaultCss;
+  }
+
+  let mainCssPath = null;
+  if (chosenCss) {
+    const resolvedCss = path.resolve(chosenCss);
+    if (fs.existsSync(resolvedCss)) {
+      mainCssPath = resolvedCss;
+    } else {
+      console.log(`\x1b[33m⚠️  Warning: File "${chosenCss}" does not exist. CSS/Tailwind configuration will be skipped.\x1b[0m`);
+    }
+  }
+
+  rl.close();
+
+  console.log('\nInstalling font files...');
+  try {
+    const tailwindVersion = detectTailwindVersion();
+    
+    await installFont({
+      slug,
+      destPath,
+      cssPath: mainCssPath || undefined,
+      tailwindVersion
+    });
+
+    console.log(`\x1b[32m✅ Copied font files to: ${chosenDest}\x1b[0m`);
+    
+    if (mainCssPath) {
+      console.log(`\x1b[32m✅ Successfully updated CSS configuration in ${path.relative(process.cwd(), mainCssPath)}\x1b[0m`);
+      if (tailwindVersion === 3) {
+        console.log(`\x1b[32m✅ Successfully extended fontFamily in tailwind.config file\x1b[0m`);
+      }
+    }
+    
+    console.log(`\n\x1b[32m\x1b[1m🎉 Font ${slug} successfully installed! You can now use it in your project.\x1b[0m`);
+  } catch (err) {
+    console.error(`\x1b[31m❌ Installation failed: ${err.message}\x1b[0m`);
+    process.exit(1);
+  }
+}
+
+main().catch(err => {
+  console.error(`\x1b[31m❌ Unexpected error: ${err.message}\x1b[0m`);
+  process.exit(1);
+});

package/fonts/joys-inter/joys-inter.css

@@ -0,0 +1,47 @@
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-300.woff2') format('woff2');
+    font-weight: 300;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-400.woff2') format('woff2');
+    font-weight: 400;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-500.woff2') format('woff2');
+    font-weight: 500;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-600.woff2') format('woff2');
+    font-weight: 600;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-700.woff2') format('woff2');
+    font-weight: 700;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysInter';
+    src: url('./woff2/joys-inter-800.woff2') format('woff2');
+    font-weight: 800;
+    font-style: normal;
+    font-display: swap;
+}
+
+.font-inter {
+    font-family: 'JoysInter', sans-serif;
+    font-weight: 400;
+}

package/fonts/joys-iran-sans-x/joys-iran-sans-x.css

@@ -0,0 +1,201 @@
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-100.woff2') format('woff2');
+    font-weight: 100;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-200.woff2') format('woff2');
+    font-weight: 200;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-300.woff2') format('woff2');
+    font-weight: 300;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-400.woff2') format('woff2');
+    font-weight: 400;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-500.woff2') format('woff2');
+    font-weight: 500;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-600.woff2') format('woff2');
+    font-weight: 600;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-700.woff2') format('woff2');
+    font-weight: 700;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-800.woff2') format('woff2');
+    font-weight: 800;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansX';
+    src: url('./woff2/joys-iran-sans-x-900.woff2') format('woff2');
+    font-weight: 900;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-100.woff2') format('woff2');
+    font-weight: 100;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-200.woff2') format('woff2');
+    font-weight: 200;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-300.woff2') format('woff2');
+    font-weight: 300;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-400.woff2') format('woff2');
+    font-weight: 400;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-500.woff2') format('woff2');
+    font-weight: 500;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-600.woff2') format('woff2');
+    font-weight: 600;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-700.woff2') format('woff2');
+    font-weight: 700;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-800.woff2') format('woff2');
+    font-weight: 800;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXFaNum';
+    src: url('./woff2/joys-iran-sans-x-fanum-900.woff2') format('woff2');
+    font-weight: 900;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-100.woff2') format('woff2');
+    font-weight: 100;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-200.woff2') format('woff2');
+    font-weight: 200;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-300.woff2') format('woff2');
+    font-weight: 300;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-400.woff2') format('woff2');
+    font-weight: 400;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-500.woff2') format('woff2');
+    font-weight: 500;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-600.woff2') format('woff2');
+    font-weight: 600;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-700.woff2') format('woff2');
+    font-weight: 700;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-800.woff2') format('woff2');
+    font-weight: 800;
+    font-style: normal;
+    font-display: swap;
+}
+@font-face {
+    font-family: 'JoysIranSansXNoEn';
+    src: url('./woff2/joys-iran-sans-x-noen-900.woff2') format('woff2');
+    font-weight: 900;
+    font-style: normal;
+    font-display: swap;
+}
+.font-iran-sans-x {
+    font-family: 'JoysIranSansX', sans-serif;
+    font-weight: 400;
+}
+.font-iran-sans-x-fanum {
+    font-family: 'JoysIranSansXFaNum', sans-serif;
+    font-weight: 400;
+}
+.font-iran-sans-x-noen {
+    font-family: 'JoysIranSansXNoEn', sans-serif;
+    font-weight: 400;
+}