style(copy): lib hooks and README copy pass

README.md

@@ -53,7 +53,6 @@ src/
 │   ├── playground/   # CDL Playground components
 │   ├── quiz/         # Quiz and exam components
 │   ├── calculator/   # Gemmological calculator components
-│   ├── auth/         # Authentication and protected routes
 │   └── layout/       # Layout components (Header, Footer)
 ├── hooks/            # React hooks (useCrystalDB, useQuiz, useExam, etc.)
 ├── layouts/          # Astro layouts

src/lib/calculator/cut-grades.ts

@@ -133,8 +133,8 @@ function describe(parameter: string, value: string, grade: CutGradeBand): Parame
     Excellent: 'within ideal range',
     'Very Good': 'slightly outside ideal',
     Good: 'noticeably outside ideal',
-    Fair: 'well outside ideal — visible light leakage likely',
-    Poor: 'severe deviation — significant performance impact',
+    Fair: 'well outside ideal; visible light leakage likely',
+    Poor: 'severe deviation; significant performance impact',
   };
   return {
     parameter,

src/lib/calculator/hanneman.ts

@@ -114,7 +114,7 @@ export function combineBands(observations: HannemanCriteria[]): RIBand | null {
     return {
       min: lo,
       max: hi,
-      rationale: `Conflicting observations — please re-test. ${reasons.join(' ')}`,
+      rationale: `Conflicting observations. Please re-test. ${reasons.join(' ')}`,
     };
   }
   return {

src/lib/pleochroism/match-pleochroism.ts

@@ -193,10 +193,10 @@ export function matchPleochroism(
     const reasonParts: string[] = [];
     reasonParts.push(
       storedCount === 3
-        ? 'Trichroic — biaxial (orthorhombic, monoclinic, or triclinic).'
+        ? 'Trichroic: biaxial (orthorhombic, monoclinic, or triclinic).'
         : storedCount === 2
-          ? 'Dichroic — uniaxial (trigonal, tetragonal, or hexagonal).'
-          : 'Single observed colour — pleochroism not detectable.',
+          ? 'Dichroic: uniaxial (trigonal, tetragonal, or hexagonal).'
+          : 'Single observed colour: pleochroism not detectable.',
     );
     if (mineral.pleochroism_strength) {
       reasonParts.push(
@@ -232,7 +232,7 @@ export function interpretColourCount(count: ObservedColourCount): {
       return {
         title: 'One colour observed',
         body:
-          'The gem may be isotropic (cubic or amorphous — diamond, garnet, spinel, glass, opal), or anisotropic but viewed along its optic axis. Rotate the dichroscope and the stone; if no second colour appears at any orientation, isotropic is most likely.',
+          'The gem may be isotropic (cubic or amorphous: diamond, garnet, spinel, glass, opal), or anisotropic but viewed along its optic axis. Rotate the dichroscope and the stone; if no second colour appears at any orientation, isotropic is most likely.',
       };
     case 2:
       return {

src/lib/sanitize-svg.ts

@@ -1,6 +1,6 @@
 /**
  * SVG Sanitization utility using DOMPurify
- * Provides defense-in-depth against XSS in SVG content
+ * Provides defence-in-depth against XSS in SVG content
  */
 import DOMPurify from 'dompurify';
 

src/lib/spectroscope/reference-bands.ts

@@ -45,7 +45,7 @@ export const SPECTROSCOPE_REFERENCE: SpectroscopeReference[] = [
     familyId: 'corundum',
     name: 'Ruby (Cr-corundum)',
     bands: [
-      { wavelength: 692, also: [694], intensity: 'strong', cause: 'Cr³⁺ doublet (R-lines)', selective: true, note: 'Sharp red doublet at 692/694 nm — the textbook ruby fingerprint.' },
+      { wavelength: 692, also: [694], intensity: 'strong', cause: 'Cr³⁺ doublet (R-lines)', selective: true, note: 'Sharp red doublet at 692/694 nm: the textbook ruby fingerprint.' },
       { wavelength: 660, intensity: 'weak', cause: 'Cr³⁺' },
       { wavelength: 555, intensity: 'moderate', cause: 'Cr³⁺ broad absorption', note: 'Wide green absorption band.' },
       { wavelength: 476, intensity: 'moderate', cause: 'Cr³⁺' },
@@ -93,7 +93,7 @@ export const SPECTROSCOPE_REFERENCE: SpectroscopeReference[] = [
       { wavelength: 460, intensity: 'moderate', cause: 'Fe³⁺' },
       { wavelength: 470, intensity: 'weak', cause: 'Fe³⁺' },
     ],
-    observationNotes: 'Synthetic flame-fusion sapphire often lacks the 450 nm line — useful diagnostic.',
+    observationNotes: 'Synthetic flame-fusion sapphire often lacks the 450 nm line; useful diagnostic.',
   },
   // Almandine garnet — Fe²⁺.
   {
@@ -132,7 +132,7 @@ export const SPECTROSCOPE_REFERENCE: SpectroscopeReference[] = [
     familyId: 'zircon',
     name: 'Zircon (high type)',
     bands: [
-      { wavelength: 653, intensity: 'strong', cause: 'U⁴⁺', selective: true, note: 'Classic uranium-line at 653.5 nm — strongest in heat-treated blue zircon.' },
+      { wavelength: 653, intensity: 'strong', cause: 'U⁴⁺', selective: true, note: 'Classic uranium-line at 653.5 nm; strongest in heat-treated blue zircon.' },
       { wavelength: 659, intensity: 'moderate', cause: 'U⁴⁺' },
       { wavelength: 691, intensity: 'weak', cause: 'U⁴⁺' },
       { wavelength: 588, intensity: 'weak', cause: 'U⁴⁺' },
@@ -157,7 +157,7 @@ export const SPECTROSCOPE_REFERENCE: SpectroscopeReference[] = [
     familyId: 'diamond',
     name: 'Cape-series diamond (N3)',
     bands: [
-      { wavelength: 415, intensity: 'strong', cause: 'N3 centre', selective: true, note: 'Cape line at 415.5 nm — diagnostic of natural type-Ia diamond.' },
+      { wavelength: 415, intensity: 'strong', cause: 'N3 centre', selective: true, note: 'Cape line at 415.5 nm: diagnostic of natural type-Ia diamond.' },
       { wavelength: 478, intensity: 'weak', cause: 'N3 / H3' },
       { wavelength: 504, intensity: 'weak', cause: 'H3 (irradiated)' },
     ],

src/lib/treatments/wizard.ts

@@ -172,7 +172,7 @@ export const CLUES: ClueDef[] = [
   },
   {
     id: 'jadeite-acid-etch',
-    label: 'Jadeite — acid-etched / honeycomb surface texture',
+    label: 'Jadeite: acid-etched / honeycomb surface texture',
     effects: { bleaching: 4, 'oil-resin': 3 },
     applicableTo: ['jadeite'],
   },