numclassify 0.3.1__tar.gz → 0.3.2.1__tar.gz

{numclassify-0.3.1 → numclassify-0.3.2.1}/CHANGELOG.md

@@ -6,6 +6,19 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ---
 
+## [0.3.2.1] - 2026-06-12
+
+### Fixed
+- Search autocomplete dropdown not appearing — added fallback fetch of property names if initial Pyodide load fails, plus visible "Loading..." state in dropdown
+
+## [0.3.2] - 2026-06-12
+
+### Added
+- Search autocomplete dropdown — suggests property names as you type in the search field
+- Confetti celebration burst when a number scores >50 properties
+- Keyboard shortcuts: `C` (classify), `S` (search), `N` (Number of the Day), `?`/`H` (show shortcuts overlay)
+- `prefers-reduced-motion` support — disables all animations for accessibility
+
 ## [0.3.1] - 2026-06-12
 
 ### Added

{numclassify-0.3.1 → numclassify-0.3.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: numclassify
-Version: 0.3.1
+Version: 0.3.2.1
 Summary: The most comprehensive Python library for number classification - 3000+ number types
 Project-URL: Homepage, https://github.com/aratrikghosh2011-tech/numclassify
 Project-URL: Repository, https://github.com/aratrikghosh2011-tech/numclassify

numclassify-0.3.2.1/docs/extra/saffron.css

@@ -0,0 +1,37 @@
+:root {
+  --md-primary-fg-color: #FF9933;
+  --md-primary-fg-color--light: #FFB366;
+  --md-primary-fg-color--dark: #E6821A;
+  --md-primary-bg-color: #0A0A0F;
+  --md-primary-bg-color--light: #12121A;
+  --md-accent-fg-color: #FF9933;
+  --md-accent-fg-color--light: #FFB366;
+  --md-accent-fg-color--dark: #E6821A;
+  --md-typeset-a-color: #FF9933;
+}
+
+[data-md-color-scheme="slate"] {
+  --md-default-bg-color: #0A0A0F;
+  --md-code-bg-color: #12121A;
+}
+
+.md-header {
+  background: linear-gradient(135deg, #E6821A, #FF9933) !important;
+}
+
+.md-tabs {
+  background: #E6821A !important;
+}
+
+.md-search__form {
+  background: rgba(255,255,255,0.15) !important;
+}
+
+a:hover {
+  color: #FFB366 !important;
+}
+
+.md-footer {
+  background: #0A0A0F !important;
+  border-top: 1px solid rgba(255,153,51,0.2);
+}

{numclassify-0.3.1 → numclassify-0.3.2.1}/docs/playground.css

@@ -999,3 +999,158 @@ footer a:hover {
   .tabs { gap: 2px; }
   .tab { font-size: 12px; padding: 8px 6px; }
 }
+
+/* ── Search Autocomplete ────────────────────────────────────────────── */
+
+.autocomplete-wrap {
+  position: relative;
+  flex: 1;
+  min-width: 180px;
+}
+
+#ac-dropdown {
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  right: 0;
+  background: var(--bg-elevated);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  max-height: 220px;
+  overflow-y: auto;
+  z-index: 50;
+  display: none;
+  box-shadow: 0 8px 24px rgba(0,0,0,0.3);
+}
+
+#ac-dropdown.open { display: block; }
+
+.ac-item {
+  padding: 8px 14px;
+  font-family: 'JetBrains Mono', monospace;
+  font-size: 12px;
+  cursor: pointer;
+  transition: background 0.15s ease;
+  color: var(--text);
+}
+
+.ac-item:first-child { border-radius: 7px 7px 0 0; }
+.ac-item:last-child { border-radius: 0 0 7px 7px; }
+
+.ac-item:hover, .ac-item.selected {
+  background: var(--saffron-faint);
+  color: var(--saffron);
+}
+
+.ac-item .ac-cat {
+  float: right;
+  font-size: 10px;
+  color: var(--text-muted);
+  font-family: 'Inter', sans-serif;
+}
+
+/* ── Confetti ────────────────────────────────────────────────────────── */
+
+.confetti-container {
+  position: fixed;
+  inset: 0;
+  pointer-events: none;
+  z-index: 9999;
+  overflow: hidden;
+}
+
+.confetti-piece {
+  position: absolute;
+  width: 8px;
+  height: 8px;
+  top: -10px;
+  animation: confettiFall linear forwards;
+}
+
+@keyframes confettiFall {
+  0% {
+    transform: translateY(0) rotate(0deg) scale(1);
+    opacity: 1;
+  }
+  100% {
+    transform: translateY(100vh) rotate(720deg) scale(0.3);
+    opacity: 0;
+  }
+}
+
+/* ── Keyboard Shortcuts Overlay ──────────────────────────────────────── */
+
+.shortcuts-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0,0,0,0.6);
+  backdrop-filter: blur(4px);
+  z-index: 9998;
+  display: none;
+  align-items: center;
+  justify-content: center;
+}
+
+.shortcuts-overlay.open { display: flex; }
+
+.shortcuts-panel {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 16px;
+  padding: 32px 40px;
+  max-width: 400px;
+  width: 90%;
+  animation: slideUp 0.3s ease both;
+}
+
+.shortcuts-panel h2 {
+  font-size: 16px;
+  font-weight: 700;
+  color: var(--saffron);
+  margin-bottom: 20px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+}
+
+.shortcut-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 0;
+  border-bottom: 1px solid rgba(255,153,51,0.06);
+}
+
+.shortcut-row:last-child { border-bottom: none; }
+
+.shortcut-row .sk-key {
+  background: var(--bg-input);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 2px 8px;
+  font-family: 'JetBrains Mono', monospace;
+  font-size: 12px;
+  color: var(--saffron);
+  min-width: 28px;
+  text-align: center;
+}
+
+.shortcut-row .sk-desc {
+  font-size: 13px;
+  color: var(--text-muted);
+}
+
+.shortcuts-close {
+  margin-top: 20px;
+  width: 100%;
+}
+
+/* ── Reduced Motion ──────────────────────────────────────────────────── */
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}

{numclassify-0.3.1 → numclassify-0.3.2.1}/docs/playground.html

@@ -19,7 +19,7 @@
   <header>
     <button class="theme-toggle" onclick="toggleTheme()" title="Toggle theme"><span id="theme-icon">&#127769;</span></button>
     <div class="logo-badge">numclassify playground</div>
-    <div class="version-badge" id="version-badge">v<span id="version-text">—</span></div>
+    <div class="version-badge" id="version-badge" data-version="0.3.2.1">v<span id="version-text">—</span></div>
     <h1>Number Intelligence</h1>
     <p class="subtitle">Classify any integer into 3000+ named mathematical types — powered by real Python in your browser.</p>
   </header>
@@ -60,7 +60,7 @@
             </div>
           </div>
           <div class="tags-wrap" id="classify-tags"></div>
-          <div class="btn-row">
+          <div class="btn-row" id="batch-actions">
             <button class="btn btn-icon" onclick="copyResults()">Copy</button>
             <button class="btn btn-icon" onclick="shareURL()">Share</button>
             <button class="btn btn-icon" onclick="downloadJSON()">Download</button>
@@ -88,7 +88,10 @@
       <div class="card">
         <div class="card-title">Search by Property</div>
         <div class="input-row">
-          <input type="text" id="input-property" placeholder="Property name (e.g. prime, perfect, triangular)..." />
+          <div class="autocomplete-wrap">
+            <input type="text" id="input-property" placeholder="Property name (e.g. prime, perfect, triangular)..." autocomplete="off" />
+            <div id="ac-dropdown"></div>
+          </div>
         </div>
         <div class="input-row" style="margin-top:10px;">
           <input type="number" id="input-range-start" placeholder="From" value="1" />
@@ -166,6 +169,17 @@
 <button id="scroll-top" onclick="scrollToTop()" title="Scroll to top">&uarr;</button>
 <div id="toast"></div>
 
+<div class="shortcuts-overlay" id="shortcuts-overlay" onclick="closeShortcuts()">
+  <div class="shortcuts-panel" onclick="event.stopPropagation()">
+    <h2>Keyboard Shortcuts</h2>
+    <div class="shortcut-row"><span class="sk-key">C</span><span class="sk-desc">Classify tab</span></div>
+    <div class="shortcut-row"><span class="sk-key">S</span><span class="sk-desc">Search tab</span></div>
+    <div class="shortcut-row"><span class="sk-key">N</span><span class="sk-desc">Number of the Day</span></div>
+    <div class="shortcut-row"><span class="sk-key">?</span><span class="sk-desc">Toggle this panel</span></div>
+    <button class="btn shortcuts-close" onclick="closeShortcuts()">Close</button>
+  </div>
+</div>
+
 <script src="playground.js"></script>
 </body>
 </html>

{numclassify-0.3.1 → numclassify-0.3.2.1}/docs/playground.js

@@ -5,6 +5,7 @@ let allProperties = [];
 let searchPage = 0;
 const SEARCH_PAGE_SIZE = 50;
 let searchResultsAll = [];
+let batchMode = false;
 
 // ── Utility ──────────────────────────────────────────────────────────────
 
@@ -166,20 +167,22 @@ function makeTags(props, container, delayBase = 0) {
 
 // ── Score Counter Animation ──────────────────────────────────────────────
 
-function animateScore(el, target, duration = 400) {
+function animateScore(target, duration = 400) {
+  const counter = document.querySelector('#classify-score .score-count');
+  if (!counter) return;
   const start = performance.now();
-  const startVal = 0;
   function step(now) {
     const t = Math.min((now - start) / duration, 1);
     const ease = 1 - Math.pow(1 - t, 3);
-    const current = Math.round(startVal + (target - startVal) * ease);
-    el.textContent = current + ' properties';
+    const current = Math.round(target * ease);
+    counter.textContent = current;
     if (t < 1) requestAnimationFrame(step);
     else {
-      el.textContent = target + ' properties';
-      el.classList.remove('pulse');
-      void el.offsetWidth;
-      el.classList.add('pulse');
+      counter.textContent = target;
+      const badge = $('classify-score');
+      badge.classList.remove('pulse');
+      void badge.offsetWidth;
+      badge.classList.add('pulse');
     }
   }
   requestAnimationFrame(step);
@@ -225,12 +228,18 @@ json.dumps(m)
     console.warn('Could not load category map', e);
   }
 
-  // Fetch version number
+  // Fetch version number — prefer local source version as canonical
+  const badge = $('version-badge');
+  const srcVersion = badge ? badge.dataset.version : null;
   try {
-    const ver = await pyodide.runPythonAsync('nc.__version__');
-    $('version-text').textContent = ver;
+    const pypiVer = await pyodide.runPythonAsync('nc.__version__');
+    // Use the source version (from pyproject.toml) since PyPI may lag behind
+    $('version-text').textContent = srcVersion || pypiVer;
+    if (srcVersion && pypiVer !== srcVersion) {
+      badge.title = 'Source: v' + srcVersion + '  |  PyPI: v' + pypiVer;
+    }
   } catch(e) {
-    $('version-text').textContent = '0.3.0';
+    $('version-text').textContent = srcVersion || '?';
   }
 
   setProgress(100, 'Ready!');
@@ -256,6 +265,13 @@ json.dumps(m)
 
 async function doClassify(n = null) {
   if (!requireReady()) return;
+  // If no explicit number and input contains commas/spaces, go to batch mode
+  if (n === null) {
+    const raw = $('input-classify').value.trim();
+    if (raw.includes(',') || /\s/.test(raw)) {
+      return doBatchClassify();
+    }
+  }
   const val = n !== null ? n : parseInt($('input-classify').value);
   if (isNaN(val)) { toast('Enter a valid integer.'); return; }
 
@@ -271,9 +287,12 @@ json.dumps({"number": r["number"], "score": r["score"], "props": r["true_propert
 `);
     const data = JSON.parse(result);
 
+    batchMode = false;
     renderNumber($('classify-number'), data.number);
-    animateScore($('classify-score'), data.score);
+    animateScore(data.score);
     makeTags(data.props, $('classify-tags'));
+    $('batch-actions').style.display = '';
+    if (data.score > 50) burstConfetti();
 
     const res = $('result-classify');
     res.style.display = 'block';
@@ -327,6 +346,7 @@ json.dumps(results)
 `);
     const results = JSON.parse(result);
 
+    batchMode = true;
     const res = $('result-classify');
     res.style.display = 'block';
     res.classList.remove('show');
@@ -334,7 +354,8 @@ json.dumps(results)
     res.classList.add('show');
 
     $('classify-number').innerHTML = `<span style="font-size:24px;background:none;-webkit-text-fill-color:var(--saffron);color:var(--saffron)">Batch (${results.length})</span>`;
-    $('classify-score').textContent = '';
+    $('classify-score').innerHTML = '<span class="score-count"></span>';
+    $('batch-actions').style.display = 'none';
 
     let html = '<table class="batch-table"><thead><tr><th>Number</th><th>Score</th><th>Properties</th></tr></thead><tbody>';
     results.forEach(r => {
@@ -538,6 +559,7 @@ json.dumps({"only_a": only_a, "only_b": only_b, "shared": shared})
 // ── Number of the Day ────────────────────────────────────────────────────
 
 async function computeNOTD(dateStr) {
+  if (!pyReady) return;
   try {
     if ($('notd-content')) $('notd-content').style.display = 'none';
     if ($('notd-loading')) $('notd-loading').style.display = 'block';
@@ -580,6 +602,7 @@ function onNotdDateChange(input) {
 // ── Copy & Share & Download ──────────────────────────────────────────────
 
 async function copyResults() {
+  if (batchMode) { toast('Cannot copy batch results — classify a single number first.'); return; }
   const num = $('classify-number').textContent;
   const score = $('classify-score').textContent;
   const tags = [...$('classify-tags').querySelectorAll('.tag')].map(t => t.textContent).join(', ');
@@ -606,10 +629,12 @@ function shareURL() {
 }
 
 function downloadJSON() {
+  if (batchMode) { toast('Cannot download batch results — classify a single number first.'); return; }
   const num = $('classify-number').textContent;
-  const score = $('classify-score').textContent.replace(' properties', '');
+  const scoreEl = document.querySelector('#classify-score .score-count');
+  const score = scoreEl ? parseInt(scoreEl.textContent) || 0 : 0;
   const tags = [...$('classify-tags').querySelectorAll('.tag')].map(t => t.textContent);
-  const data = { number: parseInt(num) || num, score: parseInt(score) || 0, properties: tags };
+  const data = { number: parseInt(num) || num, score, properties: tags };
   const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
   const url = URL.createObjectURL(blob);
   const a = document.createElement('a');
@@ -643,16 +668,149 @@ function scrollToTop() {
   window.scrollTo({ top: 0, behavior: 'smooth' });
 }
 
+// ── Search Autocomplete ───────────────────────────────────────────────────
+
+function setupAutocomplete() {
+  const input = $('input-property');
+  if (!input) return;
+  const dropdown = $('ac-dropdown');
+  let selectedIdx = -1;
+
+  input.addEventListener('input', async () => {
+    const val = input.value.trim().toLowerCase();
+    if (!val) { dropdown.classList.remove('open'); return; }
+
+    // Fallback: if allProperties is empty (Pyodide category fetch failed), try on-the-fly
+    if (!allProperties.length && pyReady && pyodide) {
+      try {
+        const sample = await pyodide.runPythonAsync(`
+import json
+from numclassify._registry import REGISTRY
+keys = list(REGISTRY.keys())
+json.dumps(keys)
+`);
+        const keys = JSON.parse(sample);
+        if (keys.length) {
+          allProperties = keys;
+          categoryMap = {};
+          keys.forEach(k => { categoryMap[k] = ''; });
+          console.log('Autocomplete: fallback loaded', keys.length, 'properties');
+        }
+      } catch(e) {
+        console.warn('Autocomplete fallback failed', e);
+      }
+    }
+
+    const matches = allProperties
+      .filter(p => p.includes(val))
+      .slice(0, 10);
+    if (!matches.length) {
+      if (!allProperties.length) {
+        dropdown.innerHTML = '<div class="ac-item" style="cursor:default;color:var(--text-muted)">Loading properties...</div>';
+        dropdown.classList.add('open');
+      } else {
+        dropdown.classList.remove('open');
+      }
+      return;
+    }
+    selectedIdx = -1;
+    dropdown.innerHTML = matches.map((p, i) =>
+      `<div class="ac-item${i === 0 ? ' selected' : ''}" data-prop="${p}" onclick="pickAutocomplete('${p}')">
+        ${p.replace(/_/g, ' ')}
+        <span class="ac-cat">${(categoryMap[p] || '').replace(/_/g, ' ')}</span>
+      </div>`
+    ).join('');
+    dropdown.classList.add('open');
+  });
+
+  input.addEventListener('keydown', e => {
+    const items = dropdown.querySelectorAll('.ac-item');
+    if (!items.length) return;
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      selectedIdx = Math.min(selectedIdx + 1, items.length - 1);
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      selectedIdx = Math.max(selectedIdx - 1, -1);
+    } else if (e.key === 'Enter' && selectedIdx >= 0) {
+      e.preventDefault();
+      items[selectedIdx].click();
+      return;
+    } else return;
+    items.forEach((el, i) => el.classList.toggle('selected', i === selectedIdx));
+  });
+
+  document.addEventListener('click', e => {
+    if (!input.contains(e.target) && !dropdown.contains(e.target)) {
+      dropdown.classList.remove('open');
+    }
+  });
+}
+
+function pickAutocomplete(prop) {
+  $('input-property').value = prop;
+  $('ac-dropdown').classList.remove('open');
+  doSearch();
+}
+
+// ── Confetti ──────────────────────────────────────────────────────────────
+
+function burstConfetti() {
+  const container = document.createElement('div');
+  container.className = 'confetti-container';
+  const colors = ['#FF9933', '#FF6B6B', '#4ECDC4', '#45B7D1', '#F7DC6F', '#DDA0DD', '#98D8C8', '#BB8FCE', '#FFEAA7', '#4CAF7D'];
+  for (let i = 0; i < 80; i++) {
+    const piece = document.createElement('div');
+    piece.className = 'confetti-piece';
+    const size = 4 + Math.random() * 8;
+    piece.style.width = size + 'px';
+    piece.style.height = size + 'px';
+    piece.style.background = colors[Math.floor(Math.random() * colors.length)];
+    piece.style.left = Math.random() * 100 + '%';
+    piece.style.borderRadius = Math.random() > 0.5 ? '50%' : '2px';
+    piece.style.animationDuration = (1.5 + Math.random() * 2) + 's';
+    piece.style.animationDelay = Math.random() * 0.5 + 's';
+    container.appendChild(piece);
+  }
+  document.body.appendChild(container);
+  setTimeout(() => container.remove(), 3500);
+}
+
+// ── Keyboard Shortcuts ────────────────────────────────────────────────────
+
+const SHORTCUT_MAP = {
+  c: 'classify',
+  s: 'search',
+  n: 'notd',
+};
+
+function setupShortcuts() {
+  document.addEventListener('keydown', e => {
+    if (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA') return;
+    const key = e.key.toLowerCase();
+    if (key === '?' || key === 'h') {
+      e.preventDefault();
+      $('shortcuts-overlay').classList.toggle('open');
+      return;
+    }
+    const tab = SHORTCUT_MAP[key];
+    if (tab) {
+      e.preventDefault();
+      switchTab(tab);
+    }
+  });
+}
+
+function closeShortcuts() {
+  $('shortcuts-overlay').classList.remove('open');
+}
+
 // ── Init ─────────────────────────────────────────────────────────────────
 
 document.addEventListener('DOMContentLoaded', () => {
   // Enter key support
   $('input-classify')?.addEventListener('keydown', e => {
-    if (e.key === 'Enter') {
-      const raw = e.target.value.trim();
-      if (raw.includes(',') || raw.includes(' ')) doBatchClassify();
-      else doClassify();
-    }
+    if (e.key === 'Enter') doClassify();
   });
   $('input-property')?.addEventListener('keydown', e => {
     if (e.key === 'Enter') doSearch();
@@ -668,5 +826,7 @@ document.addEventListener('DOMContentLoaded', () => {
     if ($('theme-icon')) $('theme-icon').textContent = savedTheme === 'light' ? '☀️' : '🌙';
   }
 
+  setupAutocomplete();
+  setupShortcuts();
   initPyodide();
 });

{numclassify-0.3.1 → numclassify-0.3.2.1}/mkdocs.yml

@@ -7,13 +7,17 @@ repo_name: aratrikghosh2011-tech/numclassify
 theme:
   name: material
   palette:
-    primary: indigo
-    accent: indigo
+    primary: custom
+    accent: custom
+    scheme: slate
   features:
     - navigation.tabs
     - navigation.top
     - content.code.copy
 
+extra_css:
+  - extra/saffron.css
+
 nav:
   - Home: index.md
   - API Reference: api.md

{numclassify-0.3.1 → numclassify-0.3.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "numclassify"
-version = "0.3.1"
+version = "0.3.2.1"
 description = "The most comprehensive Python library for number classification - 3000+ number types"
 authors = [{name = "Aratrik Ghosh", email = "aratrikghosh2011@gmail.com"}]
 readme = "README.md"