[feat] i18n: no-hardcoded-i18n-string ESLint rule

[nynexman4464]

Stacked on #4011. Adds an ESLint rule that flags hardcoded English string literals on user-facing props so future i18n regressions get caught at author time. All the pre-existing strings this rule flagged are fixed in #4011, so this PR is intentionally small: just the rule + wiring.

The rule — @astryx/no-hardcoded-i18n-string

Flags any string literal on a JSX attribute, object property, or destructure default whose name matches user-facing conventions:

• Exact matches: label, placeholder, title, tooltip, text, summary, message, description, hint
• Suffix patterns: *Label, *Text, *Placeholder, *Title, *Message, *Tooltip, *Hint, *Description, *Summary
• aria-* attributes that per WAI-ARIA take user-visible text: aria-label, aria-description, aria-placeholder, aria-roledescription, aria-valuetext, aria-braillelabel, aria-brailleroledescription, aria-keyshortcuts. Attributes taking IDs, booleans, or enum tokens are intentionally not flagged.

Ignores test files (*.test.*, __tests__/**), Storybook stories, doc files, and non-user-facing string shapes (single lowercase words, SCREAMING_SNAKE constants, URLs, paths, empty strings).

Configuration follows the plugin's existing pattern — error in strict mode (CI / agents), warn in recommended (local dev).

Portable

The rule is filesystem-agnostic — no paths are hardcoded in the rule source. Downstream packages that build on astryx and ship translatable UI can enable it too, scoped with the standard flat-config files / ignores pattern:

{
  files: ["packages/mypackage/src/**/*.{ts,tsx}"],
  plugins: { '@astryx': astryxPlugin },
  rules: {
    '@astryx/no-hardcoded-i18n-string': 'error',
  },
}

In this repo it is registered under the existing astryx config (already scoped to packages/core/src/**) plus an override that turns it off for packages/core/src/i18n/** — the runtime that defines the strings.

Testing

• pnpm -F @astryxdesign/core lint: 0 errors, 0 warnings for the new rule (all pre-existing violations fixed in [feat] i18n: route remaining 33 hardcoded strings through useTranslator() #4011).
• pnpm lint across the whole repo: only pre-existing unrelated warnings.

Follow-ups

• i18n: enforce camelCase for astryx catalog keys via ESLint rule #3920 — still relevant: catalog-key camelCase lint rule (this PR enforces where strings live but not what the keys are named).
• AI contribution guide: document i18n patterns (useTranslator, prop-default aliasing, config maps) #3931 — AI contribution guide update covering the alias-and-resolve pattern.

Refs #3641, builds on #4011

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
astryx	Ready	Preview, Comment	Jul 17, 2026 9:15pm

[github-actions]

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

🧪 Sandbox Preview

View Sandbox for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

No new or modified components detected.

Bundle Size Summary

Package	Size (ESM)	Size (CJS)	Gzipped
@astryxdesign/core	N/A	4.7KB	0B

Accessibility Audit

Status: No accessibility violations detected.

---

_{Generated by PR Enrichment workflow | Storybook | Sandbox | View full report}