@shaquillehinds/react-native-svg-icons 0.1.0 → 0.1.2

package/bin/find-icon.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_NAME = '@shaquillehinds/react-native-svg-icons';
+
+const CANDIDATE_TYPE_PATHS = [
+  path.join(__dirname, '..', 'src', 'svgs', 'types.ts'),
+  path.join(__dirname, '..', 'lib', 'typescript', 'svgs', 'types.d.ts'),
+  path.join(__dirname, '..', 'lib', 'commonjs', 'svgs', 'types.d.ts'),
+];
+
+const HELP = `
+  rnsi-icons — look up real icon names from ${PACKAGE_NAME}
+
+  Names in this set are irregular and some are misspelled. Search here rather
+  than guessing.
+
+  Usage
+    npx rnsi-icons <query> [--type filled|outline] [--exact] [--limit N]
+    npx rnsi-icons --list [--type filled|outline]
+
+  Options
+    --type <t>   restrict to one variant (default: both)
+    --exact      exact, case-sensitive match only
+    --limit N    cap results (default 40, 0 for no cap)
+    --json       machine-readable output
+    --shared     with --list, only names present in both variants
+    --diff       show names that exist in one variant but not the other
+    --help       show this message
+
+  Examples
+    npx rnsi-icons search
+    npx rnsi-icons arrow --type outline --limit 100
+    npx rnsi-icons Trash --exact
+    npx rnsi-icons --diff
+    npx rnsi-icons --list --shared > icons.txt
+`;
+
+function loadSource() {
+  for (const p of CANDIDATE_TYPE_PATHS) {
+    if (fs.existsSync(p)) return fs.readFileSync(p, 'utf8');
+  }
+  return null;
+}
+
+function parseUnion(source, typeName) {
+  const start = source.indexOf('export type ' + typeName);
+  if (start === -1) return [];
+  const end = source.indexOf(';', start);
+  const block = source.slice(start, end === -1 ? undefined : end);
+  const names = [];
+  const re = /'([^']+)'/g;
+  let m;
+  while ((m = re.exec(block)) !== null) names.push(m[1]);
+  return names;
+}
+
+function flag(argv, name) {
+  return argv.includes('--' + name);
+}
+
+function value(argv, name, fallback) {
+  const i = argv.indexOf('--' + name);
+  if (i === -1 || i === argv.length - 1) return fallback;
+  return argv[i + 1];
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+
+  if (flag(argv, 'help') || argv.includes('-h') || argv.length === 0) {
+    process.stdout.write(HELP);
+    return;
+  }
+
+  const source = loadSource();
+  if (!source) {
+    console.error(
+      `rnsi-icons: could not locate the icon type definitions.\n` +
+        `Is ${PACKAGE_NAME} installed?`
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const filled = parseUnion(source, 'FilledIconName');
+  const outline = parseUnion(source, 'OutlineIconName');
+
+  if (!filled.length && !outline.length) {
+    console.error(
+      $lf(93),
+      'rnsi-icons: parsed zero icon names — the types file may have changed shape.'
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const asJson = flag(argv, 'json');
+  const exact = flag(argv, 'exact');
+  const type = value(argv, 'type', null);
+  const limitRaw = value(argv, 'limit', '40');
+  const limit = Number(limitRaw) === 0 ? Infinity : Number(limitRaw) || 40;
+
+  if (type && type !== 'filled' && type !== 'outline') {
+    console.error(
+      $lf(105),
+      `rnsi-icons: --type must be "filled" or "outline", got "${type}".`
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const filledSet = new Set(filled);
+  const outlineSet = new Set(outline);
+
+  if (flag(argv, 'diff')) {
+    const onlyFilled = filled.filter((n) => !outlineSet.has(n));
+    const onlyOutline = outline.filter((n) => !filledSet.has(n));
+    if (asJson) {
+      process.stdout.write(
+        JSON.stringify({ onlyFilled, onlyOutline }, null, 2) + '\n'
+      );
+      return;
+    }
+    console.log(
+      $lf(120),
+      `filled: ${filled.length}   outline: ${outline.length}`
+    );
+    console.log(
+      $lf(121),
+      `shared: ${filled.filter((n) => outlineSet.has(n)).length}\n`
+    );
+    console.log(
+      $lf(122),
+      'filled only:  ' + (onlyFilled.join(', ') || '(none)')
+    );
+    console.log(
+      $lf(123),
+      'outline only: ' + (onlyOutline.join(', ') || '(none)')
+    );
+    return;
+  }
+
+  let pool;
+  if (type === 'filled') pool = filled.map((n) => [n, 'filled']);
+  else if (type === 'outline') pool = outline.map((n) => [n, 'outline']);
+  else {
+    const all = new Set([...filled, ...outline]);
+    pool = [...all].sort().map((n) => {
+      const inF = filledSet.has(n);
+      const inO = outlineSet.has(n);
+      return [n, inF && inO ? 'both' : inF ? 'filled' : 'outline'];
+    });
+  }
+
+  if (flag(argv, 'list')) {
+    let rows = pool;
+    if (flag(argv, 'shared')) rows = rows.filter(([, v]) => v === 'both');
+    if (asJson) {
+      process.stdout.write(
+        JSON.stringify(
+          rows.map(([n, v]) => ({ name: n, variant: v })),
+          null,
+          2
+        ) + '\n'
+      );
+      return;
+    }
+    rows.forEach(([n]) => console.log($lf(146), n));
+    return;
+  }
+
+  const VALUE_FLAGS = new Set(['--type', '--limit']);
+  let query = null;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (VALUE_FLAGS.has(arg)) {
+      i++; // skip this flag's value
+      continue;
+    }
+    if (arg.startsWith('-')) continue;
+    query = arg;
+    break;
+  }
+
+  if (!query) {
+    console.error(
+      $lf(164),
+      'rnsi-icons: no query given. Run with --help for usage.'
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const q = query.toLowerCase();
+  const matches = pool.filter(([n]) =>
+    exact ? n === query : n.toLowerCase().includes(q)
+  );
+
+  // Prefix matches first, then shortest — closest names surface at the top.
+  matches.sort((a, b) => {
+    const ap = a[0].toLowerCase().startsWith(q) ? 0 : 1;
+    const bp = b[0].toLowerCase().startsWith(q) ? 0 : 1;
+    if (ap !== bp) return ap - bp;
+    if (a[0].length !== b[0].length) return a[0].length - b[0].length;
+    return a[0].localeCompare(b[0]);
+  });
+
+  if (asJson) {
+    process.stdout.write(
+      JSON.stringify(
+        matches.map(([n, v]) => ({ name: n, variant: v })),
+        null,
+        2
+      ) + '\n'
+    );
+    return;
+  }
+
+  if (!matches.length) {
+    console.log($lf(191), `No icon matches "${query}".`);
+    console.log(
+      $lf(192),
+      'Try a shorter fragment, or run: npx rnsi-icons --list'
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const shown = matches.slice(0, limit);
+  const width = Math.max(...shown.map(([n]) => n.length));
+  shown.forEach(([n, v]) => console.log($lf(199), n.padEnd(width + 2) + v));
+
+  if (matches.length > shown.length) {
+    console.log(
+      `\n… ${matches.length - shown.length} more. Use --limit 0 to show all.`
+    );
+  }
+}
+
+main();
+function $lf(n) {
+  return '$lf|bin/find-icon.js:' + n + ' >';
+  // Automatically injected by Log Location Injector vscode extension
+}

package/bin/install-rules.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_NAME = '@shaquillehinds/react-native-svg-icons';
+const SLUG = 'react-native-svg-icons';
+const SOURCE = path.join(__dirname, '..', 'rules', 'AGENT_RULES.md');
+
+const TARGETS = {
+  agents: 'AGENTS.md',
+  cursor: path.join('.cursor', 'rules', SLUG + '.mdc'),
+  claude: path.join('.claude', 'rules', SLUG + '.md'),
+  codex: path.join('.codex', 'rules', SLUG + '.md'),
+  copilot: path.join('.github', 'instructions', SLUG + '.instructions.md'),
+  windsurf: path.join('.windsurf', 'rules', SLUG + '.md'),
+};
+
+const HELP = `
+  rnsi-rules — install the ${PACKAGE_NAME} agent rules
+
+  Usage
+    npx rnsi-rules [target|path] [--force] [--print]
+
+  Targets
+    (none)     ./AGENTS.md
+    agents     ./AGENTS.md
+    cursor     ./.cursor/rules/${SLUG}.mdc          (alwaysApply)
+    claude     ./.claude/rules/${SLUG}.md
+    codex      ./.codex/rules/${SLUG}.md
+    copilot    ./.github/instructions/${SLUG}.instructions.md
+    windsurf   ./.windsurf/rules/${SLUG}.md
+    <path>     any path ending in .md or .mdc
+
+  Options
+    --force    overwrite an existing file
+    --print    write nothing, print the rules to stdout
+    --help     show this message
+
+  Examples
+    npx rnsi-rules
+    npx rnsi-rules cursor
+    npx rnsi-rules docs/ai/svg-icons.md --force
+`;
+
+function frontmatterFor(target) {
+  if (target === 'cursor') {
+    return [
+      '---',
+      `description: How to use ${PACKAGE_NAME} correctly`,
+      'globs:',
+      'alwaysApply: true',
+      '---',
+      '',
+      '',
+    ].join('\n');
+  }
+  if (target === 'copilot') {
+    return ['---', "applyTo: '**/*.tsx,**/*.ts'", '---', '', ''].join('\n');
+  }
+  if (target === 'windsurf') {
+    return ['---', 'trigger: always_on', '---', '', ''].join('\n');
+  }
+  return '';
+}
+
+function resolveTarget(arg) {
+  if (!arg) return { target: 'agents', relPath: TARGETS.agents };
+  if (Object.prototype.hasOwnProperty.call(TARGETS, arg)) {
+    return { target: arg, relPath: TARGETS[arg] };
+  }
+  if (/\.mdx?$|\.mdc$/.test(arg)) {
+    return { target: 'custom', relPath: arg };
+  }
+  return null;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  const force = argv.includes('--force') || argv.includes('-f');
+  const print = argv.includes('--print');
+  const help = argv.includes('--help') || argv.includes('-h');
+  const positional = argv.filter((a) => !a.startsWith('-'))[0];
+
+  if (help) {
+    process.stdout.write(HELP);
+    return;
+  }
+
+  let rules;
+  try {
+    rules = fs.readFileSync(SOURCE, 'utf8');
+  } catch (err) {
+    console.error(
+      `rnsi-rules: could not read the rules file at ${SOURCE}\n` +
+        `Is ${PACKAGE_NAME} installed?`
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  if (print) {
+    process.stdout.write(rules);
+    return;
+  }
+
+  const resolved = resolveTarget(positional);
+  if (!resolved) {
+    console.error(
+      `rnsi-rules: unknown target "${positional}".\n` +
+        `Expected one of: ${Object.keys(TARGETS).join(', ')} — or a path ending in .md / .mdc.\n` +
+        `Run "npx rnsi-rules --help" for usage.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  const { target, relPath } = resolved;
+  const outPath = path.resolve(process.cwd(), relPath);
+
+  if (fs.existsSync(outPath) && !force) {
+    console.error(
+      `rnsi-rules: ${relPath} already exists. Re-run with --force to overwrite.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  fs.mkdirSync(path.dirname(outPath), { recursive: true });
+  fs.writeFileSync(outPath, frontmatterFor(target) + rules, 'utf8');
+
+  console.log($lf(139), `rnsi-rules: wrote ${relPath}`);
+  if (target === 'agents') {
+    console.log(
+      'Tip: if you already have an AGENTS.md, use a custom path instead and ' +
+        'link to it, e.g. npx rnsi-rules docs/ai/svg-icons.md'
+    );
+  }
+}
+
+main();
+function $lf(n) {
+  return '$lf|bin/install-rules.js:' + n + ' >';
+  // Automatically injected by Log Location Injector vscode extension
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@shaquillehinds/react-native-svg-icons",
   "description": "React Native SVG Icons",
   "author": "Shaquille Hinds <shaqdulove@gmail.com> (https://github.com/shaquillehinds)",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -22,12 +22,18 @@
       }
     }
   },
+  "bin": {
+    "rnsi-rules": "./bin/install-rules.js",
+    "rnsi-icons": "./bin/find-icon.js"
+  },
   "files": [
     "lib",
     "src",
     "android",
     "ios",
     "cpp",
+    "rules",
+    "bin",
     "*.podspec",
     "react-native.config.js",
     "!ios/build",