taste-lint 0.0.1

package/data/rules/product/product-select-for-few-options.yaml

@@ -0,0 +1,24 @@
+# Hand-authored from mblode/agent-skills skills/product-design/references/rules.md (rule/control-matches-cardinality), a deterministic
+# slice named in skills/product-design/references/lint-patterns.md.
+id: product-select-for-few-options
+title: A select with two or three static options
+categoryId: control-choice
+source:
+  repo: mblode/agent-skills
+  path: skills/product-design/references/rules.md
+  line: 72
+  ruleId: rule/control-matches-cardinality
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  flags: gus
+  regex: "<(select|Select)\\b[^>]*>(?:\\s*<(option|SelectItem)\\b[^>]*>[^<]*</\\2>){2,3}\\s*</\\1>"
+severity: minor
+fix:
+  hint: >-
+    Two or three mutually exclusive options read better as radio buttons or a segmented control with every option visible. A select hides the choices behind a click.
+# review-only: a regex over markup cannot see dynamically rendered children or
+# a modal opened from a handler; the finding is a candidate for a person.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/schema/rule.schema.json

@@ -0,0 +1,262 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "taste-lint rule",
+  "description": "Editor completion only. The source of truth is src/rules/validate.ts. Tier, domain and (for every unit but source) scope are derived, not written.",
+  "type": "object",
+  "required": [
+    "id",
+    "title",
+    "categoryId",
+    "source",
+    "unit",
+    "severity",
+    "fix"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+    },
+    "title": {
+      "type": "string"
+    },
+    "categoryId": {
+      "type": "string"
+    },
+    "source": {
+      "type": "object",
+      "required": ["repo", "path"],
+      "additionalProperties": false,
+      "properties": {
+        "repo": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "line": {
+          "type": "integer"
+        },
+        "ruleId": {
+          "type": "string"
+        }
+      }
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "include": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "exclude": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "unit": {
+      "type": "array",
+      "items": {
+        "enum": [
+          "paragraph",
+          "heading",
+          "jsx-text",
+          "attr-string",
+          "class-list",
+          "element",
+          "source"
+        ]
+      }
+    },
+    "mechanical": {
+      "type": "object",
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": ["regex"]
+        },
+        {
+          "required": ["phrases"]
+        }
+      ],
+      "properties": {
+        "regex": {
+          "type": "string"
+        },
+        "flags": {
+          "type": "string"
+        },
+        "phrases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "minMatches": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "absent": {
+          "type": "string"
+        }
+      }
+    },
+    "question": {
+      "type": "object",
+      "required": ["instructions"],
+      "additionalProperties": false,
+      "properties": {
+        "instructions": {
+          "type": "string"
+        },
+        "context": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "headingAbove",
+              "docType",
+              "element",
+              "role",
+              "neighbours",
+              "writingFacts",
+              "writingProfile",
+              "writingInstructions",
+              "section"
+            ]
+          }
+        },
+        "criteria": {
+          "type": "object",
+          "required": ["true", "false"],
+          "properties": {
+            "true": {
+              "$ref": "#/$defs/side"
+            },
+            "false": {
+              "$ref": "#/$defs/side"
+            }
+          }
+        }
+      }
+    },
+    "thresholds": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "review": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "act": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    },
+    "severity": {
+      "enum": ["major", "minor"]
+    },
+    "fix": {
+      "type": "object",
+      "required": ["hint"],
+      "additionalProperties": false,
+      "properties": {
+        "hint": {
+          "type": "string"
+        },
+        "function": {
+          "type": "string"
+        }
+      }
+    },
+    "preconditions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "notInCode": {
+          "const": true
+        },
+        "docType": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "tutorial",
+              "howto",
+              "reference",
+              "explanation",
+              "agent-instructions",
+              "lesson",
+              "marketing",
+              "ui",
+              "readme",
+              "skill",
+              "plan",
+              "personal",
+              "pr",
+              "slides",
+              "unknown"
+            ]
+          }
+        },
+        "role": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "heading",
+              "body",
+              "list-item",
+              "cell",
+              "button",
+              "link",
+              "label",
+              "placeholder",
+              "aria",
+              "literal-copy",
+              "caption",
+              "unknown"
+            ]
+          }
+        },
+        "smartQuotesAtBuild": {
+          "const": false
+        }
+      }
+    },
+    "status": {
+      "enum": ["active", "draft", "review-only"]
+    },
+    "handWritten": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "side": {
+      "type": "object",
+      "required": ["what", "examples"],
+      "properties": {
+        "what": {
+          "type": "string"
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        }
+      }
+    }
+  }
+}

package/data/rules/tuning.json

@@ -0,0 +1 @@
+{}

package/data/rules/typography/typography-dashes.yaml

@@ -0,0 +1,28 @@
+# Ported from mblode/agent-skills skills/typography-audit/rules/punct-dashes.md.
+id: typography-dashes
+title: Double hyphen or spaced hyphen standing in for a dash
+categoryId: typographic-detail
+source:
+  line: 7
+  path: skills/typography-audit/rules/punct-dashes.md
+  repo: mblode/agent-skills
+  ruleId: punct-dashes
+unit:
+  - paragraph
+  - heading
+  - jsx-text
+  - attr-string
+mechanical:
+  regex: (?<=\S)--(?=\S)|(?<=\p{L}) - (?=\p{L})
+  flags: gu
+severity: minor
+fix:
+  hint: Use the real character. Pick spaced en dashes or unspaced em dashes for asides and keep one style across the project, or restructure with a comma, colon or period where the project bans dashes.
+preconditions:
+  notInCode: true
+  docType:
+    [tutorial, howto, reference, explanation, lesson, marketing, ui, unknown]
+status: active
+handWritten:
+  - mechanical
+  - fix

package/data/rules/typography/typography-ellipsis.yaml

@@ -0,0 +1,27 @@
+# Ported from mblode/agent-skills skills/ui-design/guidelines/copywriting.md (in-progress states) and
+# skills/typography-audit/rules/punct-symbols.md.
+id: typography-ellipsis
+title: Three periods instead of an ellipsis character
+categoryId: typographic-detail
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ui-design/guidelines/copywriting.md,
+    line: 17,
+  }
+unit: [paragraph, heading, jsx-text, attr-string]
+mechanical:
+  regex: "\\.\\.\\."
+  flags: gu
+severity: minor
+fix:
+  function: ellipsis
+  hint: Use the single ellipsis character (U+2026), for example "Saving…".
+preconditions:
+  {
+    notInCode: true,
+    docType:
+      [tutorial, howto, reference, explanation, lesson, marketing, ui, unknown],
+  }
+status: active
+handWritten: [mechanical, fix]

package/data/rules/typography/typography-hover-weight-shift.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/type-hover-weight-shift.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: typography-hover-weight-shift
+title: Do not change font-weight on hover or selected
+categoryId: reading-comfort
+source:
+  line: 10
+  path: skills/ui-design/rules/type-hover-weight-shift.md
+  repo: mblode/agent-skills
+  ruleId: type-hover-weight-shift
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+    - "**/*.css"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: hover:font-(?:thin|extralight|light|normal|medium|semibold|bold|extrabold|black)|data-\[(?:state=active|selected)\]:font-|aria-selected:font-|aria-current:font-
+severity: minor
+fix:
+  hint: Bumping `font-weight` on hover, focus, or selected nav items makes the label wider, so neighbours shift. The user sees the row jump rather than a state change. Use color, opacity, background, or underline for selected and hover; keep the weight stable.
+status: review-only

package/data/rules/typography/typography-midpoint-separators.yaml

@@ -0,0 +1,21 @@
+# Ported from mblode/agent-skills skills/typography-audit/rules/punct-midpoints.md.
+id: typography-midpoint-separators
+title: Pipe or bullet used as an inline separator
+categoryId: typographic-detail
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/typography-audit/rules/punct-midpoints.md,
+    line: 7,
+  }
+unit: [jsx-text, attr-string, paragraph]
+mechanical:
+  regex: "\\S \\| \\S|\\S • \\S"
+  flags: gu
+severity: minor
+fix:
+  hint: Separate inline metadata with a midpoint (·) flanked by thin spaces, not a pipe or a bullet.
+preconditions:
+  { notInCode: true, role: [body, caption, label, list-item, cell, unknown] }
+status: active
+handWritten: [mechanical, fix, preconditions]

package/data/rules/typography/typography-multiplication-sign.yaml

@@ -0,0 +1,27 @@
+# Ported from mblode/agent-skills skills/typography-audit/rules/punct-fractions.md.
+id: typography-multiplication-sign
+title: The letter x used as a multiplication sign
+categoryId: typographic-detail
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/typography-audit/rules/punct-fractions.md,
+    line: 7,
+  }
+unit: [paragraph, heading, jsx-text, attr-string]
+mechanical:
+  # Dimensions like 1920x1080 or 3 x 4. Multipliers such as 10x are left alone.
+  regex: "(?<![\\w.])[1-9]\\d*\\s?x\\s?\\d+(?![\\w.%])"
+  flags: gu
+severity: minor
+fix:
+  function: multiplicationSign
+  hint: Use the multiplication sign (U+00D7), for example 1920×1080.
+preconditions:
+  {
+    notInCode: true,
+    docType:
+      [tutorial, howto, reference, explanation, lesson, marketing, ui, unknown],
+  }
+status: active
+handWritten: [mechanical, fix]

package/data/rules/typography/typography-nbsp-value-unit.yaml

@@ -0,0 +1,27 @@
+# Sourced from mblode/taste-training apps/web/components/demos/intersections/full-stack-audit.tsx (missing-nbsp)
+# and agent-skills skills/typography-audit/rules/layout-widows-orphans.md.
+id: typography-nbsp-value-unit
+title: Breaking space between a value and its unit
+categoryId: typographic-detail
+source:
+  {
+    repo: mblode/taste-training,
+    path: apps/web/components/demos/intersections/full-stack-audit.tsx,
+    line: 110,
+  }
+unit: [paragraph, jsx-text, attr-string]
+mechanical:
+  regex: "\\d (?:px|pt|em|rem|ms|min|KB|MB|GB|TB|kg|km|cm|mm|fps|%)(?![\\p{L}\\d])"
+  flags: gu
+severity: minor
+fix:
+  function: nbspValueUnit
+  hint: Put a no-break space (U+00A0) between the number and its unit so "10 MB" never splits across lines.
+preconditions:
+  {
+    notInCode: true,
+    docType:
+      [tutorial, howto, reference, explanation, lesson, marketing, ui, unknown],
+  }
+status: active
+handWritten: [mechanical, fix]

package/data/rules/typography/typography-readable-scale.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/type-readable-scale.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: typography-readable-scale
+title: Set a Readable Type Scale
+categoryId: reading-comfort
+source:
+  line: 9
+  path: skills/ui-design/rules/type-readable-scale.md
+  repo: mblode/agent-skills
+  ruleId: type-readable-scale
+scope:
+  include:
+    - "**/*.css"
+    - "**/*.scss"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: (?:\bbody\b|\bhtml\b|:root|\.prose)[^{}/]*\{[^}]*font-(?:size:\s*(?:0?\.\d+rem|(?<![\d.])(?:\d|1[0-5])(?:\.\d+)?px)|weight:\s*[123]00\b)
+severity: minor
+fix:
+  hint: Use body sizes and weights readable across desktop and mobile. Undersized or underweight body text slows scanning and tires readers.
+status: review-only

package/data/rules/typography/typography-straight-quotes.yaml

@@ -0,0 +1,37 @@
+# Ported from mblode/agent-skills skills/typography-audit/rules/punct-smart-quotes.md.
+# Hand-written keys are listed in handWritten; scripts/port-rules.ts never overwrites them.
+id: typography-straight-quotes
+title: Straight quotes in rendered copy
+categoryId: typographic-detail
+source:
+  repo: mblode/agent-skills
+  path: skills/typography-audit/rules/punct-smart-quotes.md
+  line: 7
+unit: [paragraph, heading, jsx-text, attr-string]
+mechanical:
+  # A straight double quote anywhere, or a straight apostrophe between letters
+  # (it's, don't) or before a decade (the '90s). Code spans are masked first.
+  regex: "\"|(?<=\\p{L})'(?=\\p{L})|(?<=\\s)'(?=\\d)"
+  flags: gu
+severity: minor
+fix:
+  function: smartQuotes
+  hint: Replace with the matching curly mark. Opening after whitespace or at the start, closing otherwise; an apostrophe is always the right single quote.
+preconditions:
+  notInCode: true
+  docType:
+    [
+      tutorial,
+      howto,
+      reference,
+      explanation,
+      lesson,
+      marketing,
+      ui,
+      unknown,
+      readme,
+      personal,
+    ]
+  smartQuotesAtBuild: false
+status: active
+handWritten: [mechanical, fix, preconditions]

package/data/rules/typography/typography-title-case-heading.yaml

@@ -0,0 +1,49 @@
+# Ported from mblode/agent-skills skills/typography-audit/rules/punct-case-rules.md and
+# skills/ui-design/guidelines/copywriting.md (sentence case everywhere).
+id: typography-title-case-heading
+title: Heading, button or label set in Title Case
+categoryId: typographic-detail
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/typography-audit/rules/punct-case-rules.md,
+    line: 7,
+  }
+scope:
+  exclude:
+    - "**/README.md"
+unit: [heading, jsx-text, attr-string]
+mechanical:
+  # Three or more consecutive capitalised words. Proper nouns also match, so Jev decides.
+  regex: "\\b[A-Z][a-z]+(?: (?:[A-Z][a-z]+|of|the|and|for|to|a|in|on|with)){2,}\\b"
+  flags: gu
+question:
+  context: [role]
+  instructions: >-
+    The TEXT is a heading, button label, tab or field label. Return true when most of its words start with a capital letter because it is set in Title Case, not because those words are names of people, products, places or organisations. Return false when the capitals are proper nouns or acronyms, when the TEXT is a single word, or when it is an ordinary sentence with one capital at the start.
+  criteria:
+    true:
+      what: Ordinary words capitalised as a heading style.
+      examples:
+        - "Manage Your Team Settings"
+        - "Get Started With Billing"
+        - "Save Changes"
+    false:
+      what: Capitals that belong to names, or a sentence-case line.
+      examples:
+        - "Connect Google Drive and Microsoft Teams"
+        - "Manage your team settings"
+        - "New York office hours"
+thresholds: { review: 0.4, act: 0.75 }
+severity: minor
+fix:
+  hint: Set headings, buttons, labels and tabs in sentence case, and apply the choice everywhere.
+preconditions:
+  {
+    notInCode: true,
+    role: [heading, button, label, aria],
+    docType:
+      [tutorial, howto, reference, explanation, lesson, marketing, ui, unknown],
+  }
+status: review-only
+handWritten: [mechanical, question, fix, preconditions, thresholds]

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {}