@cascivo/eslint-config 0.2.3 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascivo/eslint-config",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "private": false,
   "description": "Flat ESLint config for apps using cascivo — reconciles the signal-based reactivity contract with eslint-plugin-react-hooks 7",
   "keywords": [
@@ -38,6 +38,9 @@
     "access": "public",
     "provenance": true
   },
+  "dependencies": {
+    "@cascivo/eslint-plugin": "0.1.1"
+  },
   "scripts": {
     "build": "echo 'eslint-config: plain ESM, no build'",
     "test": "node --test src/index.test.js"

package/src/index.d.ts

@@ -22,6 +22,14 @@ export interface CascadeFlatConfig {
  */
 export declare const cascivoSignals: CascadeFlatConfig
 
+/**
+ * Enables `cascivo/prop-vocabulary` at **warn** — the rule that answers a wrong prop guess
+ * with the prop that exists (`<Text tone=…>` → `muted`, `gap="4"` → `gap={4}`,
+ * `const { theme } = useTheme()` → the tuple). Kept at `warn` deliberately: an error over a
+ * naming opinion gets this whole config deleted.
+ */
+export declare const cascivoPropVocabulary: CascadeFlatConfig
+
 /**
  * Scopes host stylistic rules off source vendored by `cascivo add`. Copy-paste path only.
  *
@@ -29,6 +37,6 @@ export declare const cascivoSignals: CascadeFlatConfig
  */
 export declare function cascivoVendoredSource(glob?: string): CascadeFlatConfig
 
-/** Both fragments. Spread last in your flat config — last-wins. */
+/** Every fragment. Spread last in your flat config — last-wins. */
 declare const cascivo: CascadeFlatConfig[]
 export default cascivo

package/src/index.js

@@ -47,10 +47,11 @@
  * Prefer the pieces individually when you only vendor source, or only use the package:
  *
  * ```js
- * import { cascivoSignals, cascivoVendoredSource } from '@cascivo/eslint-config'
- * export default [...yourConfig, cascivoSignals, cascivoVendoredSource()]
+ * import { cascivoSignals, cascivoPropVocabulary, cascivoVendoredSource } from '@cascivo/eslint-config'
+ * export default [...yourConfig, cascivoSignals, cascivoPropVocabulary, cascivoVendoredSource()]
  * ```
  */
+import cascivoPlugin from '@cascivo/eslint-plugin'
 
 /**
  * Reconciles `eslint-plugin-react-hooks@7` with cascivo's signal-based reactivity.
@@ -147,7 +148,27 @@ export function cascivoVendoredSource(glob = 'src/components/ui/**') {
   }
 }
 
-/** Both fragments, in the order flat config wants them. Spread last. */
-const cascivo = [cascivoSignals, cascivoVendoredSource()]
+/**
+ * The near-miss prop messages, at `warn`.
+ *
+ * `<Text tone="subtle">` is a correct TypeScript error whose text — "Property 'tone' does not
+ * exist on type 'TextProps'" — names the mistake and teaches nothing, so the adopter goes
+ * looking for the docs. That is the dependency the 2026-08-21 report named: "the docs are
+ * doing work the API should eventually do itself." Most of that work moved into the types;
+ * this rule carries the part TypeScript structurally cannot say. See
+ * `@cascivo/eslint-plugin`'s `prop-vocabulary.js` for the full rationale.
+ *
+ * **`warn`, never `error`.** A lint rule that fails somebody's build over a naming opinion
+ * gets the whole config deleted — and that takes `react-hooks/immutability` with it, which is
+ * the thing this package exists for. Raise it yourself if you want it enforced.
+ */
+export const cascivoPropVocabulary = {
+  name: 'cascivo/prop-vocabulary',
+  plugins: { cascivo: cascivoPlugin },
+  rules: { 'cascivo/prop-vocabulary': 'warn' },
+}
+
+/** All three fragments, in the order flat config wants them. Spread last. */
+const cascivo = [cascivoSignals, cascivoPropVocabulary, cascivoVendoredSource()]
 
 export default cascivo