diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..c8b84fe --- /dev/null +++ b/.github/CODE_OF_CONDUCT.md @@ -0,0 +1,35 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our community include: +* Demonstrating empathy and kindness toward other people +* Being respectful of differing opinions, viewpoints, and experiences +* Giving and gracefully accepting constructive feedback +* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience +* Focusing on what is best not just for us as individuals, but for the overall community + +Examples of unacceptable behavior include: +* The use of sexualized language or imagery, and sexual attention or advances of any kind +* Trolling, insulting or derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or email address, without their explicit permission +* Other conduct which could reasonably be considered inappropriate in a professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project leaders at `conduct@tidyfactor.com`. All complaints will be reviewed and investigated promptly and fairly. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1. diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 0000000..371a369 --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,46 @@ +# Contributing to TidyFactor Styler + +Thank you for your interest in contributing to **TidyFactor Styler** (`@alwkala/tidyfactor-styler`)! + +This repository follows strict **TidyFactor Skill Methodology** guidelines to ensure deterministic workflows, anti-slop design execution, and cross-platform compatibility across AI Coding Agents (*Google Antigravity, Claude Code, Cursor, Codex, Windsurf*). + +--- + +## 🛠️ Development & Validation Workflow + +1. **Clone & Setup**: + ```bash + git clone https://github.com/TidyFactor/Styler.git + cd Styler + ``` + +2. **Validate Skill Integrity**: + Every change must satisfy the structural rules and YAML/frontmatter compliance: + ```bash + npm run validate + # or: python tools/validate_skill.py + ``` + +3. **Build Packages & Bundles**: + ```bash + npm run build + # or: node tools/build-skill.js + ``` + +--- + +## 🌿 Branching & Pull Requests + +1. **Branch Naming**: + - `feature/`: New framework integrations, presets, or workflows. + - `fix/`: Bug fixes or validation corrections. + - `docs/`: Documentation, guides, or Arabic localization updates. + +2. **Commit Hygiene & SemVer**: + - Updates must synchronize version references across `.tidyfactor`, `package.json`, `brand.json`, `README.md`, and `CHANGELOG.md`. + - Never commit ad-hoc changes without passing `npm run validate`. + +3. **Submitting a Pull Request**: + - Fill out the PR template completely. + - Link all relevant issues. + - Confirm automated integrity validation passes. diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..a7bfa61 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,52 @@ +name: "🐛 Bug Report" +description: "File a reproducible defect or styling issue in tidyfactor-styler" +title: "[Bug]: " +labels: ["type:bug", "status:triage"] +body: + - type: markdown + attributes: + value: "Thank you for reporting a problem in TidyFactor Styler. Please provide detailed reproduction steps." + - type: input + id: version + attributes: + label: "Styler Version / Release" + description: "Which version of @alwkala/tidyfactor-styler are you using?" + placeholder: "v1.1.1" + validations: + required: true + - type: dropdown + id: target_framework + attributes: + label: "Target Framework / Environment" + options: + - "Tailwind CSS v3 / v4" + - "Next.js (App Router / Pages Router)" + - "PHP (Blade / Plates / Vanilla)" + - "Vanilla HTML / CSS" + - "WordPress / Theme" + - "Other" + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: "Steps to Reproduce" + description: "Step-by-step instructions or prompt executed." + placeholder: "1. Run command '/styler component'\n2. Pass layout '...'\n3. Observe RTL layout discrepancy" + validations: + required: true + - type: textarea + id: expected + attributes: + label: "Expected Behavior" + description: "What did you expect the styler output to look like?" + validations: + required: true + - type: textarea + id: actual + attributes: + label: "Actual Behavior / Output Snippet" + description: "Paste the actual generated code or styling bug." + render: shell + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..ffe6468 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: "💬 TidyFactor Discussions" + url: "https://github.com/TidyFactor/Styler/discussions" + about: "Ask questions, share design ideas, and discuss UI architecture." + - name: "🛡️ Security Advisory" + url: "https://github.com/TidyFactor/Styler/security/advisories/new" + about: "Report a vulnerability privately." diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..6052533 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,30 @@ +name: "✨ Feature Request" +description: "Suggest a new UI pattern, framework preset, or RTL enhancement" +title: "[Feature]: " +labels: ["type:feature", "status:triage"] +body: + - type: markdown + attributes: + value: "Have an idea or design pattern you'd like TidyFactor Styler to support? Tell us about it!" + - type: textarea + id: problem + attributes: + label: "Use Case / Missing Capability" + description: "What UI pattern, framework style, or RTL transformation are you trying to achieve?" + placeholder: "When working with..." + validations: + required: true + - type: textarea + id: solution + attributes: + label: "Proposed Style Preset or Solution" + description: "Describe how the new styler workflow or component preset should look/behave." + validations: + required: true + - type: textarea + id: alternatives + attributes: + label: "Alternatives Considered" + description: "Any alternative workarounds or designs you considered." + validations: + required: false diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..e18b6fa --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,19 @@ +## 🎯 What Changed? + + +## 💡 Why? + +Closes # + +## 🛠️ Implementation Details + + +## 🧪 Verification Checklist +- [ ] Validated skill integrity (`npm run validate` / `python tools/validate_skill.py`) +- [ ] No regression in token hierarchy or framework styler engines +- [ ] Documentation (`README.md` & `README.ar.md`) updated if applicable +- [ ] No hardcoded or non-deterministic file paths + +## ⚠️ Breaking Changes +- [ ] No breaking changes +- [ ] Breaking change (describe migration path below) diff --git a/.github/SECURITY.md b/.github/SECURITY.md new file mode 100644 index 0000000..4b3a033 --- /dev/null +++ b/.github/SECURITY.md @@ -0,0 +1,30 @@ +# Security Policy + +## Supported Versions + +We actively provide security patches and updates for the following versions: + +| Version | Supported | +| ------- | ------------------ | +| 1.1.x | :white_check_mark: | +| 1.0.x | :white_check_mark: | +| < 1.0 | :x: | + +--- + +## Reporting a Vulnerability + +We take the security of TidyFactor Styler and its associated workflows seriously. Please do not report security vulnerabilities via public GitHub issues or discussions. + +1. **Private Reporting**: + - Open a private security report through [GitHub Security Advisories](https://github.com/TidyFactor/Styler/security/advisories/new). + - Alternatively, email `security@tidyfactor.com` or `hello@tidyfactor.com`. + +2. **Details to Include**: + - Description of the vulnerability and attack vector. + - Exact steps or script to reproduce the issue. + - Potential impact on users or downstream implementations. + +3. **Response SLA**: + - Acknowledgement within **48 hours**. + - Coordinated disclosure and patch release in accordance with standard SemVer rules. diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..383fdb7 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,19 @@ +version: 2 +updates: + - package-ecosystem: "npm" + directory: "/" + schedule: + interval: "weekly" + open-pull-requests-limit: 5 + labels: + - "dependencies" + - "security" + + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" + open-pull-requests-limit: 5 + labels: + - "actions" + - "security" diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..161e286 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,36 @@ +name: CI + +on: + push: + branches: [main] + pull_request: + branches: [main] + +concurrency: + group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} + cancel-in-progress: true + +permissions: + contents: read + +jobs: + validate: + name: Skill Integrity & Linter + runs-on: ubuntu-latest + timeout-minutes: 10 + steps: + - name: Checkout Code + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 + + - name: Set up Python + uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5.4.0 + with: + python-version: "3.11" + + - name: Set up Node.js + uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0 + with: + node-version: "20" + + - name: Run Integrity Validation + run: python tools/validate_skill.py diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0781590 --- /dev/null +++ b/.gitignore @@ -0,0 +1,39 @@ +# Node & Dependencies +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* +package-lock.json + +# Python & Caches +__pycache__/ +*.py[cod] +*$py.class +*.so +.Python +env/ +venv/ +.venv/ + +# Build & Archives +dist/ +build/ +*.skill +*.zip +*.tar.gz +*.tgz + +# OS & IDE Files +.DS_Store +Thumbs.db +*.swp +*.swo +*~ +.idea/ +.vscode/ +*.sublime-project +*.sublime-workspace + +# Scratch & Logs +scratch/ +*.log diff --git a/.tidyfactor b/.tidyfactor index cf89c58..d95f77b 100644 --- a/.tidyfactor +++ b/.tidyfactor @@ -2,7 +2,7 @@ "ecosystem": "tidyfactor", "track": "js", "name": "tidyfactor-js", - "version": "1.1.0", + "version": "1.2.0", "npmPackage": "@alwkala/tidyfactor-js", "github": "https://github.com/TidyFactor/JS", "skillFile": "../tidyfactor-js-v1.1.0.skill", @@ -30,4 +30,4 @@ "website": "https://tidyfactor.com", "docs": "https://tidyfactor.com/documentation", "license": "Apache-2.0" -} \ No newline at end of file +} diff --git a/CHANGELOG.md b/CHANGELOG.md index 0e3c6b9..0be2a93 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to the **[@alwkala/tidyfactor-js](https://www.npmjs.com/package/@alwkala/tidyfactor-js)** package will be documented in this file. +## [1.2.0] - 2026-08-29 + +### Added - Global Multi-Tier & Multi-Language Documentation Architecture +- **Rule 13 Implementation**: Two-tier documentation separation between Canonical Technical Documentation (`README.md` SSOT) and First-Class Market Localizations. +- **Universal Multi-Language Switcher**: Standardized 8-language switcher navigation bar across all documentation files (`EN`, `AR`, `FA`, `ES`, `PT`, `ZH`, `DE`, `FR`). +- **First-Class Localized Developer Adoption Guides**: `README.es.md`, `README.pt.md`, `README.fa.md`, `README.zh.md`, `README.de.md`, `README.fr.md`. +- **Automated Validation & Packaging**: Updated `tools/build-skill.js` and `tools/validate_skill.py`. + The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). diff --git a/README.ar.md b/README.ar.md index 8caab21..84e7bb3 100644 --- a/README.ar.md +++ b/README.ar.md @@ -1,6 +1,6 @@
-# 🟨 مهارة تايتفكتور لتطبيقات جافاسكريبت المستقلة `TidyFactor JS v1.1.0` +# 🟨 مهارة تايتفكتور لتطبيقات جافاسكريبت المستقلة `TidyFactor JS v1.2.0` ### تطبيقات الصفحة الواحدة SPA بدون أطر عمل وبنظام ES Modules النقي ومكونات الويب Web Components [![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=F7DF1E)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..956f24d --- /dev/null +++ b/README.de.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**Framework-freie reaktive Vanilla JS SPA Engine mit Client-Routing & Proxy-State für KI-Coding-Agenten** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ Schnellstart (Quickstart) + +```bash +# Installation & Direktaufruf via NPX +npx @alwkala/tidyfactor-js +``` + +Oder direkt in Ihrem KI-Assistenten aufrufen (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-js +``` + +--- + +## 📋 Befehls- & Workflow-Matrix + +| Befehl | Ziel & Ergebnis | Workflow-Referenz | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 Vollständige Technische Dokumentation + +Ausführliche Spezifikationen, Architekturguides und Tools finden Sie im [Offiziellen Technischen README auf Englisch (README.md)](README.md). diff --git a/README.es.md b/README.es.md new file mode 100644 index 0000000..65fa00d --- /dev/null +++ b/README.es.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**Motor SPA Vanilla Reactivo sin Frameworks con Enrutamiento y Gestión de Estado Proxy para Agentes de IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ Inicio Rápido (Quickstart) + +```bash +# Instalación e invocación vía NPX +npx @alwkala/tidyfactor-js +``` + +O invócalo directamente dentro de tu asistente de IA (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-js +``` + +--- + +## 📋 Matriz de Comandos Principales + +| Comando | Objetivo y Resultado | Flujo de Trabajo | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 Especificación Técnica Completa + +Para la arquitectura profunda, esquemas JSON y documentación de herramientas nativas, consulta el [README Técnico en Inglés (README.md)](README.md). diff --git a/README.fa.md b/README.fa.md new file mode 100644 index 0000000..25b92ef --- /dev/null +++ b/README.fa.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**موتور برنامه‌های تک‌صفحه‌ای (SPA) وانیلا جاوااسکریپت بدون فریم‌ورک با مسیریابی و استیت پراکسی برای ایجنت‌های هوش مصنوعی** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ راه‌اندازی سریع (Quickstart) + +```bash +# نصب و اجرای مستقیم از طریق NPX +npx @alwkala/tidyfactor-js +``` + +یا فراخوانی مستقیم در دستیار برنامه‌نویسی (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-js +``` + +--- + +## 📋 ماتریس دستورات اصلی + +| دستور | هدف و نتیجه | جریان کاری (Workflow) | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 مستندات فنی کامل و رسمی + +برای دسترسی به اسکیماهای معماری، الگوهای کامل طراحی و ابزارهای بومی، به [مستندات فنی کامل به زبان انگلیسی (README.md)](README.md) مراجعه نمایید. diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 0000000..5c110f8 --- /dev/null +++ b/README.fr.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**Moteur SPA Vanilla Réactif sans Framework avec Routage Client et État Proxy pour Agents d'IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ Démarrage Rapide (Quickstart) + +```bash +# Installation et exécution via NPX +npx @alwkala/tidyfactor-js +``` + +Ou appelez-le directement depuis votre assistant IA (*Google Antigravity, Claude Code, Cursor, Codex*) : +```text +/tidyfactor-js +``` + +--- + +## 📋 Matrice des Commandes Principales + +| Commande | Objectif & Résultat | Référence de Workflow | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 Documentation Technique Complète + +Pour consulter l'architecture approfondie et les spécifications complètes, veuillez vous référer au [README Technique Officiel en Anglais (README.md)](README.md). diff --git a/README.md b/README.md index 34a548b..014790c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@
-# 🟨 TidyFactor JS `v1.1.0` +# 🟨 TidyFactor JS `v1.2.0` ### Framework-Free Reactive Vanilla SPA, Web Components & Contextual Decision Engine **The official vanilla JavaScript SPA engineering track within the TidyFactor Ecosystem.** diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 0000000..c6f3066 --- /dev/null +++ b/README.pt.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**Motor SPA Vanilla Reativo sem Frameworks com Roteamento e Estado Proxy para Agentes de IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ Início Rápido (Quickstart) + +```bash +# Instalação e execução via NPX +npx @alwkala/tidyfactor-js +``` + +Ou execute diretamente dentro do seu assistente de IA (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-js +``` + +--- + +## 📋 Matriz de Comandos Principais + +| Comando | Objetivo e Resultado | Fluxo de Trabalho | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 Especificação Técnica Canônica + +Para a arquitetura detalhada, esquemas JSON completos e código fonte nativo, consulte a [Documentação Técnica Canônica em Inglês (README.md)](README.md). diff --git a/README.zh.md b/README.zh.md new file mode 100644 index 0000000..b298ae9 --- /dev/null +++ b/README.zh.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-js `v1.2.0` + +**面向 AI 智能体的无框架响应式原生 Vanilla JS SPA 引擎** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) +[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) + +[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md) + +
+ +--- + +## ⚡ 快速上手 (Quickstart) + +```bash +# 通过 NPX 快速运行 +npx @alwkala/tidyfactor-js +``` + +或在 AI 编码助手 (*Google Antigravity, Claude Code, Cursor, Codex*) 中调用: +```text +/tidyfactor-js +``` + +--- + +## 📋 核心命令矩阵 + +| 命令 | 目标与产出 | 执行工作流 | +|---|---|---| +| `/brief` | Arquitectura de aplicación SPA Vanilla | `workflows/brief.md` | +| `/init` | Scaffolding de arquitectura modular SPA | `workflows/init.md` | +| `/store` | Gestión de estado reactivo vía Proxy | `workflows/store.md` | +| `/route` | Enrutamiento cliente sin recarga | `workflows/route.md` | +| `/compo` | Componentes funcionales reactivos | `workflows/compo.md` | + +--- + +## 📖 完整技术规范与文档 + +如需查看深层架构设计、完整 JSON Schema 契约和原生代码,请参阅[英文权威技术文档 (README.md)](README.md)。 diff --git a/brand.json b/brand.json index 3cd0cc2..e6c126b 100644 --- a/brand.json +++ b/brand.json @@ -1,6 +1,6 @@ { "name": "TidyFactor JS", - "version": "1.1.0", + "version": "1.2.0", "schemaVersion": "brand-core-v2", "meta": { "product": "TidyFactor JS", @@ -12,4 +12,4 @@ "version": "1.1.0", "lastUpdated": "2026-08-25" } -} \ No newline at end of file +} diff --git a/dist/tidyfactor-js-v1.1.0.skill b/dist/tidyfactor-js-v1.1.0.skill deleted file mode 100644 index ee3f4f4..0000000 Binary files a/dist/tidyfactor-js-v1.1.0.skill and /dev/null differ diff --git a/dist/tidyfactor-js.skill b/dist/tidyfactor-js.skill index ee3f4f4..1d86310 100644 Binary files a/dist/tidyfactor-js.skill and b/dist/tidyfactor-js.skill differ diff --git a/dist/tidyfactor-js/.tidyfactor b/dist/tidyfactor-js/.tidyfactor index cf89c58..d95f77b 100644 --- a/dist/tidyfactor-js/.tidyfactor +++ b/dist/tidyfactor-js/.tidyfactor @@ -2,7 +2,7 @@ "ecosystem": "tidyfactor", "track": "js", "name": "tidyfactor-js", - "version": "1.1.0", + "version": "1.2.0", "npmPackage": "@alwkala/tidyfactor-js", "github": "https://github.com/TidyFactor/JS", "skillFile": "../tidyfactor-js-v1.1.0.skill", @@ -30,4 +30,4 @@ "website": "https://tidyfactor.com", "docs": "https://tidyfactor.com/documentation", "license": "Apache-2.0" -} \ No newline at end of file +} diff --git a/dist/tidyfactor-js/CHANGELOG.md b/dist/tidyfactor-js/CHANGELOG.md index 0e3c6b9..0be2a93 100644 --- a/dist/tidyfactor-js/CHANGELOG.md +++ b/dist/tidyfactor-js/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to the **[@alwkala/tidyfactor-js](https://www.npmjs.com/package/@alwkala/tidyfactor-js)** package will be documented in this file. +## [1.2.0] - 2026-08-29 + +### Added - Global Multi-Tier & Multi-Language Documentation Architecture +- **Rule 13 Implementation**: Two-tier documentation separation between Canonical Technical Documentation (`README.md` SSOT) and First-Class Market Localizations. +- **Universal Multi-Language Switcher**: Standardized 8-language switcher navigation bar across all documentation files (`EN`, `AR`, `FA`, `ES`, `PT`, `ZH`, `DE`, `FR`). +- **First-Class Localized Developer Adoption Guides**: `README.es.md`, `README.pt.md`, `README.fa.md`, `README.zh.md`, `README.de.md`, `README.fr.md`. +- **Automated Validation & Packaging**: Updated `tools/build-skill.js` and `tools/validate_skill.py`. + The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). diff --git a/dist/tidyfactor-js/README.ar.md b/dist/tidyfactor-js/README.ar.md index 8caab21..84e7bb3 100644 --- a/dist/tidyfactor-js/README.ar.md +++ b/dist/tidyfactor-js/README.ar.md @@ -1,6 +1,6 @@
-# 🟨 مهارة تايتفكتور لتطبيقات جافاسكريبت المستقلة `TidyFactor JS v1.1.0` +# 🟨 مهارة تايتفكتور لتطبيقات جافاسكريبت المستقلة `TidyFactor JS v1.2.0` ### تطبيقات الصفحة الواحدة SPA بدون أطر عمل وبنظام ES Modules النقي ومكونات الويب Web Components [![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-js.svg?style=for-the-badge&color=F7DF1E)](https://www.npmjs.com/package/@alwkala/tidyfactor-js) diff --git a/dist/tidyfactor-js/README.md b/dist/tidyfactor-js/README.md index 34a548b..014790c 100644 --- a/dist/tidyfactor-js/README.md +++ b/dist/tidyfactor-js/README.md @@ -1,6 +1,6 @@
-# 🟨 TidyFactor JS `v1.1.0` +# 🟨 TidyFactor JS `v1.2.0` ### Framework-Free Reactive Vanilla SPA, Web Components & Contextual Decision Engine **The official vanilla JavaScript SPA engineering track within the TidyFactor Ecosystem.** diff --git a/dist/tidyfactor-js/brand.json b/dist/tidyfactor-js/brand.json index 3cd0cc2..e6c126b 100644 --- a/dist/tidyfactor-js/brand.json +++ b/dist/tidyfactor-js/brand.json @@ -1,6 +1,6 @@ { "name": "TidyFactor JS", - "version": "1.1.0", + "version": "1.2.0", "schemaVersion": "brand-core-v2", "meta": { "product": "TidyFactor JS", @@ -12,4 +12,4 @@ "version": "1.1.0", "lastUpdated": "2026-08-25" } -} \ No newline at end of file +} diff --git a/dist/tidyfactor-js/package.json b/dist/tidyfactor-js/package.json index e72230d..3906cae 100644 --- a/dist/tidyfactor-js/package.json +++ b/dist/tidyfactor-js/package.json @@ -1,6 +1,6 @@ { "name": "@alwkala/tidyfactor-js", - "version": "1.1.0", + "version": "1.2.0", "description": "TidyFactor Vanilla JS track — Framework-Free Reactive Vanilla SPA with Contextual Decision Layer (CDL)", "main": "SKILL.md", "bin": { @@ -36,22 +36,28 @@ "access": "public" }, "files": [ - "SKILL.md", - "references", - "memory", - "templates", - "scripts", - "tools", - "assets", - "bin", - "brand.json", ".tidyfactor", "AGENTS.md", + "CHANGELOG.md", + "LICENSE", + "README.ar.md", + "README.de.md", + "README.es.md", + "README.fa.md", + "README.fr.md", + "README.md", + "README.pt.md", + "README.zh.md", "SKILL-REGISTRY.md", + "SKILL.md", "VISION.md", - "README.md", - "README.ar.md", - "LICENSE", - "CHANGELOG.md" + "assets", + "bin", + "brand.json", + "memory", + "references", + "scripts", + "templates", + "tools" ] -} \ No newline at end of file +} diff --git a/package.json b/package.json index e72230d..3906cae 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@alwkala/tidyfactor-js", - "version": "1.1.0", + "version": "1.2.0", "description": "TidyFactor Vanilla JS track — Framework-Free Reactive Vanilla SPA with Contextual Decision Layer (CDL)", "main": "SKILL.md", "bin": { @@ -36,22 +36,28 @@ "access": "public" }, "files": [ - "SKILL.md", - "references", - "memory", - "templates", - "scripts", - "tools", - "assets", - "bin", - "brand.json", ".tidyfactor", "AGENTS.md", + "CHANGELOG.md", + "LICENSE", + "README.ar.md", + "README.de.md", + "README.es.md", + "README.fa.md", + "README.fr.md", + "README.md", + "README.pt.md", + "README.zh.md", "SKILL-REGISTRY.md", + "SKILL.md", "VISION.md", - "README.md", - "README.ar.md", - "LICENSE", - "CHANGELOG.md" + "assets", + "bin", + "brand.json", + "memory", + "references", + "scripts", + "templates", + "tools" ] -} \ No newline at end of file +}