chore(8.0): final pre-RC1 sweep — API consistency, named errors, orphans, zero-cast codebase

src/importers/SmartExcelImporter.ts

@@ -161,15 +161,9 @@ export class SmartExcelImporter {
     const opts = {
       enableNeuralExtraction: true,
       enableRelationshipInference: true,
-      // CONCEPT EXTRACTION PRODUCTION-READY:
-      // Type embeddings are now pre-computed at build time - zero runtime cost!
-      // All 42 noun types + 127 verb types instantly available
-      //
-      // Performance profile:
-      // - Type embeddings: INSTANT (pre-computed at build time, ~100KB in-memory)
-      // - Model loading: ~2-5 seconds (one-time, cached after first use)
-      // - Per-row extraction: ~50-200ms depending on definition length
-      // - 100 rows: ~5-20 seconds total (production ready)
+      // Type embeddings are pre-computed at build time (~100KB in-memory),
+      // so concept extraction costs no runtime embedding calls: model loading
+      // is a one-time ~2-5s, then ~50-200ms per row.
       // - 1000 rows: ~50-200 seconds (disable if needed via enableConceptExtraction: false)
       //
       // Enabled by default for production use.
@@ -179,7 +173,9 @@ export class SmartExcelImporter {
       definitionColumn: 'definition|description|desc|details',
       typeColumn: 'type|category|kind',
       relatedColumn: 'related|see also|links',
-      onProgress: () => {},
+      // Annotated with the full callback signature so the merged opts type has
+      // a single callable shape (the no-op default narrowed the union).
+      onProgress: (() => {}) as NonNullable<SmartExcelOptions['onProgress']>,
       ...options
     }
 
@@ -489,7 +485,7 @@ export class SmartExcelImporter {
         throughput: Math.round(rowsPerSecond * 10) / 10,
         eta: Math.round(estimatedTimeRemaining),
         phase: 'extracting'
-      } as any)
+      })
     }
 
     // Group rows by sheet for VFS extraction