@birdapi/velinstyle 1.0.0 → 1.2.0

package/packages/velinstyle-skills/skills/velin-testing-a11y-suite/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-testing-a11y-suite
+description: Runs accessibility test suite and triages regressions.
+---
+
+# Testing A11y Suite
+
+## Goal
+Deliver testing a11y suite outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: test, accessibility.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: test:a11y
+- Dependencies: velin-a11y-scan-fix
+
+## Workflow
+1. Validate inputs: html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report.
+
+## Rules
+- Respect status: stable.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-testing-a11y-suite for this page."
+- CLI bridge example: `velinstyle test:a11y`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: report.

package/packages/velinstyle-skills/skills/velin-testing-visual-smoke/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-testing-visual-smoke
+description: Runs visual smoke checks across key breakpoints.
+---
+
+# Testing Visual Smoke
+
+## Goal
+Deliver testing visual smoke outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: test, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: test:e2e
+- Dependencies: velin-dev-page-scaffold
+
+## Workflow
+1. Validate inputs: html, screenshot.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report.
+
+## Rules
+- Respect status: beta.
+- Respect priority: advanced.
+- Respect confidence: medium.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-testing-visual-smoke for this page."
+- CLI bridge example: `velinstyle test:e2e`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: report.

package/packages/velinstyle-skills/skills/velin-themes-apply-token/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-themes-apply-token
+description: Applies built-in themes through token-safe patterns.
+---
+
+# Theme Apply Token
+
+## Goal
+Deliver theme apply token outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: theme, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: themes, tokens
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: tokens, html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: css, html.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-themes-apply-token for this page."
+- CLI bridge example: `velinstyle themes`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: css, html.

package/packages/velinstyle-skills/skills/velin-themes-contrast-check/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-themes-contrast-check
+description: Checks token contrast and theme compatibility for WCAG goals.
+---
+
+# Theme Contrast Check
+
+## Goal
+Deliver theme contrast check outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: accessibility, theme, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review, scan
+- Dependencies: velin-themes-apply-token
+
+## Workflow
+1. Validate inputs: html, screenshot, tokens.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report, review-json.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-themes-contrast-check for this page."
+- CLI bridge example: `velinstyle review`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: report, review-json.

package/packages/velinstyle-skills/skills/velin-utilities-layout-apply/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-utilities-layout-apply
+description: Applies utility classes for layout and responsive structure.
+---
+
+# Utilities Layout Apply
+
+## Goal
+Deliver utilities layout apply outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, diff.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-utilities-layout-apply for this page."
+- CLI bridge example: `velinstyle review`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, diff.

package/packages/velinstyle-skills/skills/velin-utilities-prefix-fix/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-utilities-prefix-fix
+description: Normalizes classes to velin-* naming.
+---
+
+# Utilities Prefix Fix
+
+## Goal
+Deliver utilities prefix fix outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: migrate.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: prefix
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: diff, report.
+
+## Rules
+- Respect status: stable.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-utilities-prefix-fix for this page."
+- CLI bridge example: `velinstyle prefix`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: diff, report.

package/packages/velinstyle-skills/skills/velin-utilities-token-map/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-utilities-token-map
+description: Documents how utility usage maps to token taxonomy.
+---
+
+# Utilities Token Map
+
+## Goal
+Deliver utilities token map outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: theme, documentation.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: tokens
+- Dependencies: velin-utilities-layout-apply
+
+## Workflow
+1. Validate inputs: tokens, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: markdown, report.
+
+## Rules
+- Respect status: beta.
+- Respect priority: advanced.
+- Respect confidence: medium.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-utilities-token-map for this page."
+- CLI bridge example: `velinstyle tokens`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: markdown, report.

package/packages/velinstyle-skills/templates/admin-panel.template.yaml

@@ -0,0 +1,12 @@
+id: admin-panel
+workflowGraph: release-gate
+packs:
+  - enterprise
+  - review
+theme: midnight
+demo: samples/dashboard.html
+docs:
+  - docs/guides/ai-skills.html
+  - docs/guides/prompt-scaffolding.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/blog.template.yaml

@@ -0,0 +1,12 @@
+id: blog
+workflowGraph: landingpage
+packs:
+  - frontend
+  - review
+theme: default
+demo: samples/blog.html
+docs:
+  - docs/guides/ai-skills.html
+  - docs/guides/prompt-scaffolding.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/documentation-portal.template.yaml

@@ -0,0 +1,12 @@
+id: documentation-portal
+workflowGraph: component-ship
+packs:
+  - documentation
+  - review
+theme: default
+demo: docs/index.html
+docs:
+  - docs/guides/ai-skills.html
+  - docs/guides/prompt-scaffolding.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/ecommerce-shop.template.yaml

@@ -0,0 +1,13 @@
+id: ecommerce-shop
+workflowGraph: landingpage
+packs:
+  - frontend
+  - review
+  - enterprise
+theme: default
+demo: samples/ecommerce.html
+docs:
+  - docs/guides/ecommerce.html
+  - docs/guides/prompt-scaffolding.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/landing-page.template.yaml

@@ -0,0 +1,12 @@
+id: landing-page
+workflowGraph: landingpage
+packs:
+  - frontend
+  - design
+theme: default
+demo: samples/landing.html
+docs:
+  - docs/guides/prompt-scaffolding.html
+  - docs/guides/landing-15-min.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/laravel-dashboard.template.yaml

@@ -0,0 +1,11 @@
+id: laravel-dashboard
+workflowGraph: release-gate
+packs:
+  - enterprise
+  - frontend
+theme: midnight
+demo: samples/dashboard.html
+docs:
+  - docs/guides/laravel.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/marketing-website.template.yaml

@@ -0,0 +1,13 @@
+id: marketing-website
+workflowGraph: landingpage
+packs:
+  - frontend
+  - design
+  - review
+theme: default
+demo: samples/landing.html
+docs:
+  - docs/guides/prompt-scaffolding.html
+  - docs/guides/landing-15-min.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/packages/velinstyle-skills/templates/portfolio.template.yaml

@@ -0,0 +1,12 @@
+id: portfolio
+workflowGraph: landingpage
+packs:
+  - design
+  - frontend
+theme: soft
+demo: samples/portfolio.html
+docs:
+  - docs/guides/ai-skills.html
+  - docs/guides/prompt-scaffolding.html
+starterFiles:
+  - templates/vite-velinstyle/index.html

package/schemas/component-knowledge.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/component-knowledge.schema.json",
+  "title": "VelinStyle Component Knowledge Node",
+  "type": "object",
+  "required": ["id", "kind", "category", "purpose", "maturity"],
+  "properties": {
+    "id": { "type": "string" },
+    "kind": { "type": "string", "enum": ["web-component", "css-component", "pattern", "helper"] },
+    "tag": { "type": "string" },
+    "classPrefix": { "type": "string" },
+    "category": { "type": "string" },
+    "subcategory": { "type": "string" },
+    "purpose": { "type": "string" },
+    "family": { "type": "string" },
+    "maturity": { "type": "string", "enum": ["core", "advanced", "experimental"] },
+    "recommendedPages": { "type": "array", "items": { "type": "string" } },
+    "recommendedSections": { "type": "array", "items": { "type": "string" } },
+    "compatibleWith": { "type": "array", "items": { "type": "string" } },
+    "incompatibleWith": { "type": "array", "items": { "type": "string" } },
+    "accessibility": { "type": "object" },
+    "seo": { "type": "object" },
+    "performance": { "type": "object" },
+    "variants": { "type": "array", "items": { "type": "string" } },
+    "density": { "type": "array", "items": { "type": "string" } },
+    "themeSupport": { "type": "array", "items": { "type": "string" } },
+    "motion": { "type": "object" },
+    "examples": { "type": "array", "items": { "type": "string" } },
+    "promptKeywords": { "type": "array", "items": { "type": "string" } },
+    "designIntelligence": { "$ref": "https://velinstyle.info/schemas/design-intelligence.schema.json" },
+    "api": { "type": "object" }
+  }
+}

package/schemas/design-constraint.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/design-constraint.schema.json",
+  "title": "VelinStyle Design Constraint Pack",
+  "type": "object",
+  "required": ["id", "target", "rules"],
+  "properties": {
+    "id": { "type": "string" },
+    "target": { "type": "string" },
+    "rules": {
+      "type": "array",
+      "items": { "$ref": "https://velinstyle.info/schemas/design-rule.schema.json" }
+    }
+  }
+}

package/schemas/design-intelligence.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/design-intelligence.schema.json",
+  "title": "VelinStyle Design Intelligence Block",
+  "type": "object",
+  "properties": {
+    "visualWeight": { "type": "integer", "minimum": 1, "maximum": 5 },
+    "importance": { "type": "string", "enum": ["primary", "secondary", "tertiary"] },
+    "hierarchy": { "type": "string" },
+    "spacingRules": { "type": "array", "items": { "type": "string" } },
+    "typographyRules": { "type": "array", "items": { "type": "string" } },
+    "animationRules": { "type": "array", "items": { "type": "string" } },
+    "colorRules": { "type": "array", "items": { "type": "string" } },
+    "eyeFlow": { "type": "string" },
+    "compositionRules": { "type": "array", "items": { "type": "string" } },
+    "commonMistakes": { "type": "array", "items": { "type": "string" } },
+    "bestPractices": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/design-rule.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/design-rule.schema.json",
+  "title": "VelinStyle Design Rule",
+  "type": "object",
+  "required": ["id", "scope", "rule"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string" },
+    "scope": { "type": "string", "enum": ["global", "section", "component", "page"] },
+    "section": { "type": "string" },
+    "rule": { "type": "string" },
+    "breakpoints": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "severity": { "type": "string", "enum": ["error", "warning", "info"], "default": "warning" }
+  }
+}

package/schemas/page-template.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/page-template.schema.json",
+  "title": "VelinStyle Page Template",
+  "type": "object",
+  "required": ["id", "name", "requiredSections"],
+  "properties": {
+    "id": { "type": "string" },
+    "name": { "type": "string" },
+    "audience": { "type": "string" },
+    "businessType": { "type": "string" },
+    "pageGoal": { "type": "string" },
+    "conversionGoal": { "type": "string" },
+    "requiredSections": { "type": "array", "items": { "type": "string" } },
+    "optionalSections": { "type": "array", "items": { "type": "string" } },
+    "forbiddenSections": { "type": "array", "items": { "type": "string" } },
+    "seoIntent": { "type": "string" },
+    "accessibilityRisks": { "type": "array", "items": { "type": "string" } },
+    "defaultTone": { "type": "string" },
+    "recommendedComponents": { "type": "array", "items": { "type": "string" } },
+    "designConstraintIds": { "type": "array", "items": { "type": "string" } },
+    "promptKeywords": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/review-report.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://velinstyle.info/schemas/review-report.schema.json",
+  "title": "VelinStyle Review Report",
+  "type": "object",
+  "required": ["version", "scores", "issues"],
+  "properties": {
+    "version": { "type": "integer" },
+    "promptScore": { "type": "number" },
+    "scores": {
+      "type": "object",
+      "properties": {
+        "design": { "type": "number" },
+        "accessibility": { "type": "number" },
+        "seo": { "type": "number" },
+        "performance": { "type": "number" },
+        "conversion": { "type": "number" },
+        "visual": { "type": "number" }
+      }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "severity", "message"],
+        "properties": {
+          "code": { "type": "string" },
+          "severity": { "type": "string", "enum": ["error", "warning", "info"] },
+          "message": { "type": "string" },
+          "fix": { "type": "string" }
+        }
+      }
+    },
+    "gate": { "type": "string", "enum": ["pass", "warn", "fail"] }
+  }
+}