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 0bba0db..ddd1895 100644 --- a/.tidyfactor +++ b/.tidyfactor @@ -2,7 +2,7 @@ "ecosystem": "tidyfactor", "track": "html", "name": "tidyfactor-html", - "version": "1.1.0", + "version": "1.2.0", "npmPackage": "@alwkala/tidyfactor-html", "github": "https://github.com/TidyFactor/HTML", "skillFile": "../tidyfactor-html-v1.1.0.skill", @@ -28,4 +28,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 2ac0a69..001e026 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to the **[@alwkala/tidyfactor-html](https://www.npmjs.com/package/@alwkala/tidyfactor-html)** 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 9993eba..cb4b8d7 100644 --- a/README.ar.md +++ b/README.ar.md @@ -1,6 +1,6 @@
-# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.1.0` +# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.2.0` ### محرك المواقع الثابتة بنسبة 100% ومكونات الويب Web Components لوكلاء الذكاء الاصطناعي [![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=E34F26)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..0edc033 --- /dev/null +++ b/README.de.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**Static HTML/CSS/JS Platform Starter & Web Components Engine ohne Server-Runtime für KI-Coding-Agenten** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +Oder direkt in Ihrem KI-Assistenten aufrufen (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-html +``` + +--- + +## 📋 Befehls- & Workflow-Matrix + +| Befehl | Ziel & Ergebnis | Workflow-Referenz | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.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..ce93180 --- /dev/null +++ b/README.es.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**Starter de Plataforma Estática HTML/CSS/JS y Componentes Web con Cero Runtime de Servidor para Agentes de IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +O invócalo directamente dentro de tu asistente de IA (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-html +``` + +--- + +## 📋 Matriz de Comandos Principales + +| Comando | Objetivo y Resultado | Flujo de Trabajo | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.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..948aae2 --- /dev/null +++ b/README.fa.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**پایه‌گذار پلتفرم‌های ایستا HTML/CSS/JS و وب‌کامپوننت‌ها بدون نیاز به ران‌تایم سرور برای ایجنت‌های هوش مصنوعی** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +یا فراخوانی مستقیم در دستیار برنامه‌نویسی (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-html +``` + +--- + +## 📋 ماتریس دستورات اصلی + +| دستور | هدف و نتیجه | جریان کاری (Workflow) | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.md` | + +--- + +## 📖 مستندات فنی کامل و رسمی + +برای دسترسی به اسکیماهای معماری، الگوهای کامل طراحی و ابزارهای بومی، به [مستندات فنی کامل به زبان انگلیسی (README.md)](README.md) مراجعه نمایید. diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 0000000..5bc842a --- /dev/null +++ b/README.fr.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**Starter de Plateforme Statique HTML/CSS/JS et Web Components sans Runtime Serveur pour Agents d'IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +Ou appelez-le directement depuis votre assistant IA (*Google Antigravity, Claude Code, Cursor, Codex*) : +```text +/tidyfactor-html +``` + +--- + +## 📋 Matrice des Commandes Principales + +| Commande | Objectif & Résultat | Référence de Workflow | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.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 599fd30..a32786b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@
-# 🌐 TidyFactor HTML `v1.1.0` +# 🌐 TidyFactor HTML `v1.2.0` ### 100% Static Platform Starter, Web Components & Contextual Decision Engine **The official static web engineering track within the TidyFactor Architecture Ecosystem.** diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 0000000..a8021d1 --- /dev/null +++ b/README.pt.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**Starter de Plataforma Estática HTML/CSS/JS e Web Components com Zero Runtime de Servidor para Agentes de IA** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +Ou execute diretamente dentro do seu assistente de IA (*Google Antigravity, Claude Code, Cursor, Codex*): +```text +/tidyfactor-html +``` + +--- + +## 📋 Matriz de Comandos Principais + +| Comando | Objetivo e Resultado | Fluxo de Trabalho | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.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..7c78c7c --- /dev/null +++ b/README.zh.md @@ -0,0 +1,44 @@ +
+ +# tidyfactor-html `v1.2.0` + +**面向 AI 智能体的零服务端依赖静态 HTML/CSS/JS 与 Web Components 平台脚手架** + +[![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) +[![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-html +``` + +或在 AI 编码助手 (*Google Antigravity, Claude Code, Cursor, Codex*) 中调用: +```text +/tidyfactor-html +``` + +--- + +## 📋 核心命令矩阵 + +| 命令 | 目标与产出 | 执行工作流 | +|---|---|---| +| `/brief` | Definición de arquitectura estática | `workflows/brief.md` | +| `/init` | Scaffolding de proyecto HTML/CSS modular | `workflows/init.md` | +| `/compo` | Creación de Web Components nativos | `workflows/compo.md` | +| `/pages` | Construcción de páginas estáticas | `workflows/pages.md` | +| `/deploy` | Optimización para GitHub Pages y hosting estático | `workflows/deploy.md` | + +--- + +## 📖 完整技术规范与文档 + +如需查看深层架构设计、完整 JSON Schema 契约和原生代码,请参阅[英文权威技术文档 (README.md)](README.md)。 diff --git a/brand.json b/brand.json index 203112e..1cbf2bc 100644 --- a/brand.json +++ b/brand.json @@ -1,6 +1,6 @@ { "name": "TidyFactor HTML", - "version": "1.1.0", + "version": "1.2.0", "schemaVersion": "brand-core-v2", "meta": { "product": "TidyFactor HTML", @@ -12,4 +12,4 @@ "version": "1.1.0", "lastUpdated": "2026-08-25" } -} \ No newline at end of file +} diff --git a/dist/tidyfactor-html-v1.1.0.skill b/dist/tidyfactor-html-v1.1.0.skill deleted file mode 100644 index 2ab2e97..0000000 Binary files a/dist/tidyfactor-html-v1.1.0.skill and /dev/null differ diff --git a/dist/tidyfactor-html.skill b/dist/tidyfactor-html.skill index 2ab2e97..1241c25 100644 Binary files a/dist/tidyfactor-html.skill and b/dist/tidyfactor-html.skill differ diff --git a/dist/tidyfactor-html/.tidyfactor b/dist/tidyfactor-html/.tidyfactor index 0bba0db..ddd1895 100644 --- a/dist/tidyfactor-html/.tidyfactor +++ b/dist/tidyfactor-html/.tidyfactor @@ -2,7 +2,7 @@ "ecosystem": "tidyfactor", "track": "html", "name": "tidyfactor-html", - "version": "1.1.0", + "version": "1.2.0", "npmPackage": "@alwkala/tidyfactor-html", "github": "https://github.com/TidyFactor/HTML", "skillFile": "../tidyfactor-html-v1.1.0.skill", @@ -28,4 +28,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-html/CHANGELOG.md b/dist/tidyfactor-html/CHANGELOG.md index 2ac0a69..001e026 100644 --- a/dist/tidyfactor-html/CHANGELOG.md +++ b/dist/tidyfactor-html/CHANGELOG.md @@ -2,6 +2,14 @@ All notable changes to the **[@alwkala/tidyfactor-html](https://www.npmjs.com/package/@alwkala/tidyfactor-html)** 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-html/README.ar.md b/dist/tidyfactor-html/README.ar.md index 9993eba..cb4b8d7 100644 --- a/dist/tidyfactor-html/README.ar.md +++ b/dist/tidyfactor-html/README.ar.md @@ -1,6 +1,6 @@
-# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.1.0` +# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.2.0` ### محرك المواقع الثابتة بنسبة 100% ومكونات الويب Web Components لوكلاء الذكاء الاصطناعي [![npm version](https://img.shields.io/npm/v/@alwkala/tidyfactor-html.svg?style=for-the-badge&color=E34F26)](https://www.npmjs.com/package/@alwkala/tidyfactor-html) diff --git a/dist/tidyfactor-html/README.md b/dist/tidyfactor-html/README.md index 599fd30..a32786b 100644 --- a/dist/tidyfactor-html/README.md +++ b/dist/tidyfactor-html/README.md @@ -1,6 +1,6 @@
-# 🌐 TidyFactor HTML `v1.1.0` +# 🌐 TidyFactor HTML `v1.2.0` ### 100% Static Platform Starter, Web Components & Contextual Decision Engine **The official static web engineering track within the TidyFactor Architecture Ecosystem.** diff --git a/dist/tidyfactor-html/brand.json b/dist/tidyfactor-html/brand.json index 203112e..1cbf2bc 100644 --- a/dist/tidyfactor-html/brand.json +++ b/dist/tidyfactor-html/brand.json @@ -1,6 +1,6 @@ { "name": "TidyFactor HTML", - "version": "1.1.0", + "version": "1.2.0", "schemaVersion": "brand-core-v2", "meta": { "product": "TidyFactor HTML", @@ -12,4 +12,4 @@ "version": "1.1.0", "lastUpdated": "2026-08-25" } -} \ No newline at end of file +} diff --git a/dist/tidyfactor-html/package.json b/dist/tidyfactor-html/package.json index 29f3639..6f0c8c8 100644 --- a/dist/tidyfactor-html/package.json +++ b/dist/tidyfactor-html/package.json @@ -1,6 +1,6 @@ { "name": "@alwkala/tidyfactor-html", - "version": "1.1.0", + "version": "1.2.0", "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter 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 29f3639..6f0c8c8 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@alwkala/tidyfactor-html", - "version": "1.1.0", + "version": "1.2.0", "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter 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 +}