ai-text-check 1.0.0 → 1.1.0

package/README.md

@@ -14,19 +14,21 @@ Node.js 20+ is required. The package ships dual **ESM and CommonJS** builds with
 
 ## What it checks
 
-| Engine              | What it catches                                                                                            |
-| ------------------- | ---------------------------------------------------------------------------------------------------------- |
-| **polish**          | Custom AI tells (`delve`, `in today's world`, antithesis), readability, markdown structure/SEO, typography |
-| **slop-gate**       | Vocabulary pack (`nestled`, `treasure trove`, `leverage`, …)                                               |
-| **write-good**      | Weasel words, clichés, wordy phrases, passive voice                                                        |
-| **retext**          | Passive voice, readability grade, simplify, repeated words                                                 |
-| **is-this-ai-slop** | Clichés, buzzwords, em-dash spam, antithesis, sycophancy                                                   |
-| **veldica**         | Stock LLM transitions and AI-style markers                                                                 |
-| **clean-writing**   | Banned constructions, marketing adjectives, filler, intensifiers                                           |
-| **vale**            | Vendored styles: write-good, Google, AiTextCheck, ai-tells, signs-of-ai-writing                            |
+| Engine              | What it catches                                                                                                    |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| **polish**          | Custom AI tells (`delve`, emojis, `in today's world`, antithesis), readability, markdown structure/SEO, typography |
+| **slop-gate**       | Vocabulary pack (`nestled`, `treasure trove`, `leverage`, …)                                                       |
+| **write-good**      | Weasel words, clichés, wordy phrases, passive voice                                                                |
+| **retext**          | Passive voice, readability grade, simplify, repeated words                                                         |
+| **is-this-ai-slop** | Clichés, buzzwords, em-dash spam, antithesis, sycophancy                                                           |
+| **veldica**         | Stock LLM transitions and AI-style markers                                                                         |
+| **clean-writing**   | Banned constructions, marketing adjectives, filler, intensifiers                                                   |
+| **vale**            | Vendored styles: write-good, Google, AiTextCheck, ai-tells, signs-of-ai-writing                                    |
 
 Safe auto-fixes can strip filler openers and collapse extra whitespace without rewriting code fences.
 
+Emoji in prose is treated as an AI tell (`ai-emojis`). Set `ignoreEmojis: true` or pass `--ignore-emojis` to allow them; the ignore flag is off by default.
+
 ## TypeScript
 
 ```ts
@@ -111,6 +113,7 @@ npx ai-text-check init
 | `--no-slop`                             | Skip slop-gate and is-this-ai-slop |
 | `--no-write-good`                       | Skip write-good                    |
 | `--no-retext`                           | Skip retext                        |
+| `--ignore-emojis`                       | Allow emojis (skip `ai-emojis`)    |
 | `--ignore-rule ID`                      | Skip a rule (repeatable)           |
 
 Exit code `1` when issues meet the fail threshold.
@@ -126,6 +129,7 @@ Exit code `1` when issues meet the fail threshold.
   "minScore": 0,
   "extensions": [".md", ".mdx", ".markdown", ".txt"],
   "ignoreRules": [],
+  "ignoreEmojis": false,
   "checks": {
     "ai": true,
     "grammar": true,

package/dist/cli.js

@@ -736,6 +736,14 @@ function validateUserConfig(value) {
       config.ignoreRules = value.ignoreRules;
     }
   }
+  const ignoreEmojis = expectBoolean(
+    value.ignoreEmojis,
+    "ignoreEmojis",
+    errors
+  );
+  if (ignoreEmojis !== void 0) {
+    config.ignoreEmojis = ignoreEmojis;
+  }
   if (value.include !== void 0) {
     if (!isStringArray(value.include)) {
       errors.push("include must be an array of strings");
@@ -869,6 +877,7 @@ function validateUserConfig(value) {
     "failOn",
     "minScore",
     "ignoreRules",
+    "ignoreEmojis",
     "include",
     "exclude",
     "extensions",
@@ -892,7 +901,14 @@ function resolveConfig(user = {}) {
     format: user.format ?? "auto",
     failOn: user.failOn ?? "warn",
     minScore: user.minScore ?? 0,
-    ignoreRules: user.ignoreRules ?? [],
+    ignoreRules: (() => {
+      const rules = [...user.ignoreRules ?? []];
+      if (user.ignoreEmojis ?? false) {
+        rules.push("ai-emojis");
+      }
+      return rules;
+    })(),
+    ignoreEmojis: user.ignoreEmojis ?? false,
     include: user.include ?? [],
     exclude: user.exclude ?? [],
     extensions: (user.extensions ?? DEFAULT_EXTENSIONS).map(
@@ -12088,6 +12104,14 @@ var AI_PATTERN_RULES = [
     severity: "info",
     minCount: ({ words }) => Math.max(6, words / 250)
   },
+  {
+    id: "ai-emojis",
+    category: "ai",
+    pattern: new RegExp("\\p{Extended_Pictographic}", "gu"),
+    message: "Emoji can read as chatty or AI-styled in formal prose.",
+    severity: "info",
+    suggestion: "Prefer plain prose, or set ignoreEmojis: true to allow them."
+  },
   {
     id: "double-space",
     category: "typography",
@@ -13435,6 +13459,7 @@ Options:
   --no-slop          Skip slop-gate vocabulary and is-this-ai-slop
   --no-write-good    Skip the write-good grammar engine
   --no-retext        Skip retext (passive, readability, simplify, repeats)
+  --ignore-emojis    Allow emojis (skip the ai-emojis rule; off by default)
   --ignore-rule ID   Ignore a rule (repeatable)
   --config PATH      Path to ai-text-check.config.json
   --help, -h         Show this help
@@ -13442,7 +13467,8 @@ Options:
   --                 Extra flags after -- are passed to Vale
 
 By default every local engine runs: polish, slop-gate, write-good, retext,
-is-this-ai-slop, Veldica, clean-writing, and Vale.
+is-this-ai-slop, Veldica, clean-writing, and Vale. Emoji in prose is flagged
+as an AI tell unless --ignore-emojis (or ignoreEmojis: true) is set.
 
 Examples:
   ai-text-check content
@@ -13463,6 +13489,7 @@ function parseArgs(argv) {
     slop: true,
     writeGood: true,
     retext: true,
+    ignoreEmojis: false,
     ignoreRules: [],
     valeArgs: []
   };
@@ -13528,6 +13555,9 @@ function parseArgs(argv) {
       case "--no-retext":
         options.retext = false;
         break;
+      case "--ignore-emojis":
+        options.ignoreEmojis = true;
+        break;
       case "--min-score": {
         const value = Number(args[++i]);
         if (!Number.isFinite(value)) {
@@ -13588,6 +13618,7 @@ function toUserConfig(options) {
   if (options.failOn) config.failOn = options.failOn;
   if (options.minScore !== void 0) config.minScore = options.minScore;
   if (options.ignoreRules.length > 0) config.ignoreRules = options.ignoreRules;
+  if (options.ignoreEmojis) config.ignoreEmojis = true;
   const engines = {};
   if (!options.vale) engines.vale = false;
   if (!options.slop) {
@@ -13648,7 +13679,8 @@ var SAMPLE_CONFIG = `{
   "failOn": "warn",
   "minScore": 0,
   "extensions": [".md", ".mdx", ".markdown", ".txt"],
-  "ignoreRules": []
+  "ignoreRules": [],
+  "ignoreEmojis": false
 }
 `;
 function initProject(cwd, withVale) {

package/dist/index.cjs

@@ -737,6 +737,14 @@ function validateUserConfig(value) {
       config.ignoreRules = value.ignoreRules;
     }
   }
+  const ignoreEmojis = expectBoolean(
+    value.ignoreEmojis,
+    "ignoreEmojis",
+    errors
+  );
+  if (ignoreEmojis !== void 0) {
+    config.ignoreEmojis = ignoreEmojis;
+  }
   if (value.include !== void 0) {
     if (!isStringArray(value.include)) {
       errors.push("include must be an array of strings");
@@ -870,6 +878,7 @@ function validateUserConfig(value) {
     "failOn",
     "minScore",
     "ignoreRules",
+    "ignoreEmojis",
     "include",
     "exclude",
     "extensions",
@@ -893,7 +902,14 @@ function resolveConfig(user = {}) {
     format: user.format ?? "auto",
     failOn: user.failOn ?? "warn",
     minScore: user.minScore ?? 0,
-    ignoreRules: user.ignoreRules ?? [],
+    ignoreRules: (() => {
+      const rules = [...user.ignoreRules ?? []];
+      if (user.ignoreEmojis ?? false) {
+        rules.push("ai-emojis");
+      }
+      return rules;
+    })(),
+    ignoreEmojis: user.ignoreEmojis ?? false,
     include: user.include ?? [],
     exclude: user.exclude ?? [],
     extensions: (user.extensions ?? DEFAULT_EXTENSIONS).map(
@@ -12278,6 +12294,14 @@ var AI_PATTERN_RULES = [
     severity: "info",
     minCount: ({ words }) => Math.max(6, words / 250)
   },
+  {
+    id: "ai-emojis",
+    category: "ai",
+    pattern: new RegExp("\\p{Extended_Pictographic}", "gu"),
+    message: "Emoji can read as chatty or AI-styled in formal prose.",
+    severity: "info",
+    suggestion: "Prefer plain prose, or set ignoreEmojis: true to allow them."
+  },
   {
     id: "double-space",
     category: "typography",

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CheckOptions, a as CheckReport, U as UserConfig, R as ResolvedConfig, b as ReplacementStats, S as SanitizeOptions, c as Severity, I as Issue } from './types-BlvvRFG5.cjs';
-export { d as Category, e as CheckName, f as CheckSummary, g as ChecksConfig, E as EngineName, h as EnginesConfig, M as MarkdownConfig, P as PatternRule, i as PresetName, j as ReadabilityThresholds, k as SeoThresholds, T as TextFormat, l as TextStats } from './types-BlvvRFG5.cjs';
+import { C as CheckOptions, a as CheckReport, U as UserConfig, R as ResolvedConfig, b as ReplacementStats, S as SanitizeOptions, c as Severity, I as Issue } from './types-BC0TjlU0.cjs';
+export { d as Category, e as CheckName, f as CheckSummary, g as ChecksConfig, E as EngineName, h as EnginesConfig, M as MarkdownConfig, P as PatternRule, i as PresetName, j as ReadabilityThresholds, k as SeoThresholds, T as TextFormat, l as TextStats } from './types-BC0TjlU0.cjs';
 
 declare function checkText(text: string, options?: CheckOptions): CheckReport;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CheckOptions, a as CheckReport, U as UserConfig, R as ResolvedConfig, b as ReplacementStats, S as SanitizeOptions, c as Severity, I as Issue } from './types-BlvvRFG5.js';
-export { d as Category, e as CheckName, f as CheckSummary, g as ChecksConfig, E as EngineName, h as EnginesConfig, M as MarkdownConfig, P as PatternRule, i as PresetName, j as ReadabilityThresholds, k as SeoThresholds, T as TextFormat, l as TextStats } from './types-BlvvRFG5.js';
+import { C as CheckOptions, a as CheckReport, U as UserConfig, R as ResolvedConfig, b as ReplacementStats, S as SanitizeOptions, c as Severity, I as Issue } from './types-BC0TjlU0.js';
+export { d as Category, e as CheckName, f as CheckSummary, g as ChecksConfig, E as EngineName, h as EnginesConfig, M as MarkdownConfig, P as PatternRule, i as PresetName, j as ReadabilityThresholds, k as SeoThresholds, T as TextFormat, l as TextStats } from './types-BC0TjlU0.js';
 
 declare function checkText(text: string, options?: CheckOptions): CheckReport;
 

package/dist/index.js

@@ -734,6 +734,14 @@ function validateUserConfig(value) {
       config.ignoreRules = value.ignoreRules;
     }
   }
+  const ignoreEmojis = expectBoolean(
+    value.ignoreEmojis,
+    "ignoreEmojis",
+    errors
+  );
+  if (ignoreEmojis !== void 0) {
+    config.ignoreEmojis = ignoreEmojis;
+  }
   if (value.include !== void 0) {
     if (!isStringArray(value.include)) {
       errors.push("include must be an array of strings");
@@ -867,6 +875,7 @@ function validateUserConfig(value) {
     "failOn",
     "minScore",
     "ignoreRules",
+    "ignoreEmojis",
     "include",
     "exclude",
     "extensions",
@@ -890,7 +899,14 @@ function resolveConfig(user = {}) {
     format: user.format ?? "auto",
     failOn: user.failOn ?? "warn",
     minScore: user.minScore ?? 0,
-    ignoreRules: user.ignoreRules ?? [],
+    ignoreRules: (() => {
+      const rules = [...user.ignoreRules ?? []];
+      if (user.ignoreEmojis ?? false) {
+        rules.push("ai-emojis");
+      }
+      return rules;
+    })(),
+    ignoreEmojis: user.ignoreEmojis ?? false,
     include: user.include ?? [],
     exclude: user.exclude ?? [],
     extensions: (user.extensions ?? DEFAULT_EXTENSIONS).map(
@@ -12275,6 +12291,14 @@ var AI_PATTERN_RULES = [
     severity: "info",
     minCount: ({ words }) => Math.max(6, words / 250)
   },
+  {
+    id: "ai-emojis",
+    category: "ai",
+    pattern: new RegExp("\\p{Extended_Pictographic}", "gu"),
+    message: "Emoji can read as chatty or AI-styled in formal prose.",
+    severity: "info",
+    suggestion: "Prefer plain prose, or set ignoreEmojis: true to allow them."
+  },
   {
     id: "double-space",
     category: "typography",

package/dist/node.cjs

@@ -742,6 +742,14 @@ function validateUserConfig(value) {
       config.ignoreRules = value.ignoreRules;
     }
   }
+  const ignoreEmojis = expectBoolean(
+    value.ignoreEmojis,
+    "ignoreEmojis",
+    errors
+  );
+  if (ignoreEmojis !== void 0) {
+    config.ignoreEmojis = ignoreEmojis;
+  }
   if (value.include !== void 0) {
     if (!isStringArray(value.include)) {
       errors.push("include must be an array of strings");
@@ -875,6 +883,7 @@ function validateUserConfig(value) {
     "failOn",
     "minScore",
     "ignoreRules",
+    "ignoreEmojis",
     "include",
     "exclude",
     "extensions",
@@ -898,7 +907,14 @@ function resolveConfig(user = {}) {
     format: user.format ?? "auto",
     failOn: user.failOn ?? "warn",
     minScore: user.minScore ?? 0,
-    ignoreRules: user.ignoreRules ?? [],
+    ignoreRules: (() => {
+      const rules = [...user.ignoreRules ?? []];
+      if (user.ignoreEmojis ?? false) {
+        rules.push("ai-emojis");
+      }
+      return rules;
+    })(),
+    ignoreEmojis: user.ignoreEmojis ?? false,
     include: user.include ?? [],
     exclude: user.exclude ?? [],
     extensions: (user.extensions ?? DEFAULT_EXTENSIONS).map(
@@ -12373,6 +12389,14 @@ var AI_PATTERN_RULES = [
     severity: "info",
     minCount: ({ words }) => Math.max(6, words / 250)
   },
+  {
+    id: "ai-emojis",
+    category: "ai",
+    pattern: new RegExp("\\p{Extended_Pictographic}", "gu"),
+    message: "Emoji can read as chatty or AI-styled in formal prose.",
+    severity: "info",
+    suggestion: "Prefer plain prose, or set ignoreEmojis: true to allow them."
+  },
   {
     id: "double-space",
     category: "typography",

package/dist/node.d.cts

@@ -1,4 +1,4 @@
-import { U as UserConfig, R as ResolvedConfig, C as CheckOptions, a as CheckReport, f as CheckSummary } from './types-BlvvRFG5.cjs';
+import { U as UserConfig, R as ResolvedConfig, C as CheckOptions, a as CheckReport, f as CheckSummary } from './types-BC0TjlU0.cjs';
 
 declare class ConfigError extends Error {
     readonly name = "ConfigError";

package/dist/node.d.ts

@@ -1,4 +1,4 @@
-import { U as UserConfig, R as ResolvedConfig, C as CheckOptions, a as CheckReport, f as CheckSummary } from './types-BlvvRFG5.js';
+import { U as UserConfig, R as ResolvedConfig, C as CheckOptions, a as CheckReport, f as CheckSummary } from './types-BC0TjlU0.js';
 
 declare class ConfigError extends Error {
     readonly name = "ConfigError";

package/dist/node.js

@@ -734,6 +734,14 @@ function validateUserConfig(value) {
       config.ignoreRules = value.ignoreRules;
     }
   }
+  const ignoreEmojis = expectBoolean(
+    value.ignoreEmojis,
+    "ignoreEmojis",
+    errors
+  );
+  if (ignoreEmojis !== void 0) {
+    config.ignoreEmojis = ignoreEmojis;
+  }
   if (value.include !== void 0) {
     if (!isStringArray(value.include)) {
       errors.push("include must be an array of strings");
@@ -867,6 +875,7 @@ function validateUserConfig(value) {
     "failOn",
     "minScore",
     "ignoreRules",
+    "ignoreEmojis",
     "include",
     "exclude",
     "extensions",
@@ -890,7 +899,14 @@ function resolveConfig(user = {}) {
     format: user.format ?? "auto",
     failOn: user.failOn ?? "warn",
     minScore: user.minScore ?? 0,
-    ignoreRules: user.ignoreRules ?? [],
+    ignoreRules: (() => {
+      const rules = [...user.ignoreRules ?? []];
+      if (user.ignoreEmojis ?? false) {
+        rules.push("ai-emojis");
+      }
+      return rules;
+    })(),
+    ignoreEmojis: user.ignoreEmojis ?? false,
     include: user.include ?? [],
     exclude: user.exclude ?? [],
     extensions: (user.extensions ?? DEFAULT_EXTENSIONS).map(
@@ -12365,6 +12381,14 @@ var AI_PATTERN_RULES = [
     severity: "info",
     minCount: ({ words }) => Math.max(6, words / 250)
   },
+  {
+    id: "ai-emojis",
+    category: "ai",
+    pattern: new RegExp("\\p{Extended_Pictographic}", "gu"),
+    message: "Emoji can read as chatty or AI-styled in formal prose.",
+    severity: "info",
+    suggestion: "Prefer plain prose, or set ignoreEmojis: true to allow them."
+  },
   {
     id: "double-space",
     category: "typography",

package/dist/{types-BlvvRFG5.d.cts → types-BC0TjlU0.d.cts}

@@ -90,6 +90,8 @@ type UserConfig = {
     failOn?: Severity;
     minScore?: number;
     ignoreRules?: string[];
+    /** When true, skip the ai-emojis rule. Default false (emojis are flagged). */
+    ignoreEmojis?: boolean;
     include?: string[];
     exclude?: string[];
     extensions?: string[];
@@ -105,6 +107,7 @@ type ResolvedConfig = {
     failOn: Severity;
     minScore: number;
     ignoreRules: string[];
+    ignoreEmojis: boolean;
     include: string[];
     exclude: string[];
     extensions: string[];

package/dist/{types-BlvvRFG5.d.ts → types-BC0TjlU0.d.ts}

@@ -90,6 +90,8 @@ type UserConfig = {
     failOn?: Severity;
     minScore?: number;
     ignoreRules?: string[];
+    /** When true, skip the ai-emojis rule. Default false (emojis are flagged). */
+    ignoreEmojis?: boolean;
     include?: string[];
     exclude?: string[];
     extensions?: string[];
@@ -105,6 +107,7 @@ type ResolvedConfig = {
     failOn: Severity;
     minScore: number;
     ignoreRules: string[];
+    ignoreEmojis: boolean;
     include: string[];
     exclude: string[];
     extensions: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-text-check",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Detect AI-generated writing tells, grammar issues, and synthetic typography in JavaScript and TypeScript projects.",
   "license": "MIT",
   "author": "Pritam Ghosh <contact.meghoshpritam@gmail.com>",