# Nordshrift Symbol Resolution Nordshrift consumes SST declarations as typed symbols before emitting SLeeLa. ## Required stages 1. Parse an SST declaration. 2. Construct an `SSTSymbol` with package-qualified identity. 3. Resolve it through the shared `sleela::library::Index`. 4. Produce a `NordshriftSymbol`. 5. Preserve source path, kind, signature, and resolution status. 6. Reject unresolved or ambiguous symbols. 7. Emit SLeeLa only after symbol resolution succeeds. ## No duplicate registry Nordshrift must not invent a parallel `/lib` symbol database. The recursive library index remains the authoritative source for package and source-symbol existence. ## Relationship `SSTSymbol -> SSTSymbolResolution -> NordshriftSymbol -> SLeeLa symbol/IR` This contract applies to the new SST/Nordshrift classes and to future classes added to `/lib`. ## Library class vocabulary (informative mirror) The sections above are normative: `/lib` and the shared `sleela::library:: Index` are the single source of truth, and neither SST nor Nordshrift keeps a second registry. The list below is an **informative** snapshot of the package-qualified class vocabulary those layers resolve against, generated from `lib/LIBRARY.SYMBOLS.md` by `tools/generate-vocab-appendix.py`. It is a reading aid only; it carries no authority and must be regenerated (never hand-edited) when `/lib` changes. This appendix mirrors the **10995** package-qualified class symbols across **90** `/lib` package families, as recorded in the authoritative manifest `lib/LIBRARY.SYMBOLS.md`. It is **informative**: `/lib` and the shared `sleela::library::Index` remain the single source of truth, and nothing here constitutes a second registry. Each entry is resolvable as `.`. Large auto-generated families (> 40 classes) are summarized by count and facade; smaller families list every class. - **`alphabet`** (15): `Alphabet`, `AlphabetBuilder`, `ArabicAlphabet`, `Color`, `CyrillicAlphabet`, `DarkTheme`, `GreekAlphabet`, `HebrewAlphabet`, `LatinAlphabet`, `Letter`, `LightTheme`, `Palette`, `SLPackage`, `SolarizedTheme`, `Theme` - **`antivirus`** (15): `Antivirus`, `SLClamAVAdapter`, `SLDebianAntivirusProfile`, `SLFedoraAntivirusProfile`, `SLLocalScanner`, `SLMacOSAntivirusProfile`, `SLPackage`, `SLQuarantineManager`, `SLScanPolicy`, `SLScanRequest`, `SLScanResult`, `SLScannerEngine`, `SLSystemScanner`, `SLUbuntuAntivirusProfile`, `SLWindowsAntivirusProfile` - **`api`** (1): `SLPackage` - **`audio`** (1): `SLPackage` - **`autocad`** (5): `SLCadDxf`, `SLCadModel`, `SLCadPlan`, `SLCadRenderer`, `autocad` - **`bash`** (1): `SLPackage` - **`boolean`** — 270 classes (facade `boolean.SLPackage`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`character`** (15): `AdvertisingModel`, `BrokerageModel`, `BusinessModel`, `Character`, `ConsultingModel`, `FranchiseModel`, `FreemiumModel`, `LicensingModel`, `ManufacturingModel`, `MarketplaceModel`, `RetailModel`, `SLPackage`, `SaaSModel`, `SubscriptionModel`, `WholesaleModel` - **`churn`** (1): `SLPackage` - **`citizen`** (19): `AdvertisingModel`, `BankAccount`, `BrokerageModel`, `BusinessModel`, `Character`, `Citizen`, `ConsultingModel`, `FederalReserveID`, `FranchiseModel`, `FreemiumModel`, `Industry`, `LicensingModel`, `ManufacturingModel`, `MarketplaceModel`, `RetailModel`, `SLPackage`, `SaaSModel`, `SubscriptionModel`, `WholesaleModel` - **`codecs`** (27): `SLCodecAac`, `SLCodecAc3`, `SLCodecAiff`, `SLCodecAlac`, `SLCodecAmrNb`, `SLCodecAmrWb`, `SLCodecController`, `SLCodecEac3`, `SLCodecFlac`, `SLCodecG711Alaw`, `SLCodecG711Mulaw`, `SLCodecHeAac`, `SLCodecLoader`, `SLCodecMatroskaAudio`, `SLCodecMidi`, `SLCodecMp3`, `SLCodecOpus`, `SLCodecPcmWav`, `SLCodecProcessor`, `SLCodecSpeex`, `SLCodecVerifier`, `SLCodecVorbis`, `SLCodecWebmAudio`, `SLCodecWma`, `SLPackage`, `codec-pipeline`, `codecs` - **`collections`** (8): `SLArray`, `SLIterator`, `SLList`, `SLMap`, `SLQueue`, `SLRange`, `SLSet`, `SLStack` - **`common-rails`** (12): `PrintComponent`, `PrintContractTest`, `PrintField`, `PrintFormatter`, `PrintGlyphs`, `PrintLayout`, `PrintLine`, `PrintProgress`, `PrintRenderer`, `PrintState`, `PrintWriter`, `SLPackage` - **`compiler`** — 54 classes (facade `compiler.BinaryFormatReference`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`config`** (1): `SLPackage` - **`connector`** (1): `SLPackage` - **`coorenagraph`** (20): `Amoral`, `Beneficence`, `Coorenagraph`, `Deontology`, `Ethics`, `Magnanimous`, `Moral`, `MoralDeliberation`, `MoralVocabulary`, `Morale`, `Morals`, `Pernicious`, `Principled`, `Probity`, `Reprobate`, `SLPackage`, `Unscrupulous`, `Upright`, `Utilitarianism`, `VirtueEthics` - **`core`** — 84 classes (facade `core.SLPackage`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`cpu`** — 140 classes (facade `cpu.SL6502CPU`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`crypto`** (25): `SLAes`, `SLAesGcm`, `SLCertificate`, `SLCertificateStore`, `SLCipher`, `SLCipherContext`, `SLCipherKey`, `SLDigest`, `SLHkdf`, `SLHmac`, `SLKey`, `SLKeyDerivation`, `SLKeyPair`, `SLMlDsa`, `SLMlKem`, `SLNationalSuite`, `SLNonce`, `SLPrivateKey`, `SLPublicKey`, `SLSha256`, `SLSha3`, `SLSha512`, `SLSignature`, `SLTrustStore`, `SLVerifier` - **`data`** (1): `SLPackage` - **`data-structures`** (9): `DSList`, `DSMap`, `DSObject`, `DSQueue`, `DSStack`, `DSValue`, `DataStructures`, `DataStructuresTest`, `SLPackage` - **`database`** (16): `SLColumn`, `SLConnectionPool`, `SLDataSource`, `SLDatabase`, `SLDatabaseConfig`, `SLIndex`, `SLMigration`, `SLPreparedStatement`, `SLQuery`, `SLQueryParameter`, `SLResultSet`, `SLRow`, `SLSchema`, `SLStatement`, `SLTable`, `SLTransaction` - **`debugger`** (16): `SLBreakpoint`, `SLCoverage`, `SLDebugFrame`, `SLDebugSession`, `SLDebugTarget`, `SLDebugValue`, `SLDebugger`, `SLExceptionPoint`, `SLExecutionPoint`, `SLProfiler`, `SLSourceMap`, `SLStackTrace`, `SLStepController`, `SLTraceBuffer`, `SLTraceEvent`, `SLWatchpoint` - **`decompiler`** (13): `BinaryFormatReference`, `DecompilerModule`, `FractionalInput`, `LanguageReference`, `OSDiscernment`, `OutputTarget`, `ProgramMapping`, `SLPackage`, `SafetyReference`, `SleelaDecompiler`, `SourceLanguage`, `artifact-analysis`, `fractional-reconstruction` - **`deliberation`** — 295 classes (facade `deliberation.SLAStarSearch`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`drivers`** (1): `SLPackage` - **`filesystem`** (16): `SLArchive`, `SLDirectoryInfo`, `SLDirectoryReader`, `SLDirectoryWalker`, `SLFileAttributes`, `SLFileCopier`, `SLFileInfo`, `SLFileLock`, `SLFileMode`, `SLFileMover`, `SLFilePermissions`, `SLFileReader`, `SLFileWatcher`, `SLFileWriter`, `SLPathPattern`, `SLPathResolver` - **`gameplay`** (14): `AskForHelpMove`, `DetailedReport`, `DiceRoll`, `ExpectedFuture`, `GameMove`, `GameTurn`, `HelpIndexMove`, `InferenceEngine`, `ManagementCourtroom`, `MoveOutcome`, `NewDesireMove`, `Player`, `PortfolioDecision`, `SLPackage` - **`gui`** (11): `SLGuiAction`, `SLGuiBackend`, `SLGuiBridge`, `SLGuiDocument`, `SLGuiDocumentListener`, `SLGuiHost`, `SLGuiIntegration`, `SLGuiRuntime`, `SLGuiWindow`, `SLPackage`, `gui-demo` - **`html`** (1): `SLPackage` - **`http`** (17): `SLHttpBody`, `SLHttpCache`, `SLHttpClient`, `SLHttpCookie`, `SLHttpHandler`, `SLHttpHeaders`, `SLHttpMiddleware`, `SLHttpMultipart`, `SLHttpProxy`, `SLHttpRoute`, `SLHttpRouter`, `SLHttpServer`, `SLHttpSession`, `SLHttpStatus`, `SLHttpTls`, `SLHttpVersion`, `SLRouteData` - **`http-1.0`** (1): `SLPackage` - **`http-2.0`** (1): `SLPackage` - **`http-3.0`** (1): `SLPackage` - **`http-4.0`** (1): `SLPackage` - **`http-5.0`** (1): `SLPackage` - **`http-6.0`** (1): `SLPackage` - **`http-7.0`** (1): `SLPackage` - **`http-8.0`** (1): `SLPackage` - **`http-9.0`** (1): `SLPackage` - **`http-servers`** (1): `SLPackage` - **`ide`** (1): `SLPackage` - **`inference-model`** (1): `SLPackage` - **`inputs`** (1): `SLPackage` - **`international-criminal-court`** (1): `SLPackage` - **`io`** (8): `SLBufferedInput`, `SLBufferedOutput`, `SLByteStream`, `SLConsole`, `SLFileStream`, `SLInputStream`, `SLMemoryStream`, `SLOutputStream` - **`java`** — 8982 classes (facade `java.SLPackage`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`java28`** (1): `SLPackage` - **`journey`** (1): `SLPackage` - **`languages`** (4): `SLLanguage`, `SLLanguageCatalog`, `SLLanguageSettings`, `languages` - **`ledger`** (1): `SLPackage` - **`manifesto`** (1): `SLPackage` - **`math`** — 243 classes (facade `math.SLANOVA`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`memory`** (16): `SLAddress`, `SLAllocator`, `SLArena`, `SLBuffer`, `SLByteBuffer`, `SLMemory`, `SLMemoryBlock`, `SLMemoryManager`, `SLMemoryRegion`, `SLMemorySegment`, `SLMemoryStatistics`, `SLMemoryView`, `SLPointer`, `SLPoolAllocator`, `SLReference`, `SLWeakReference` - **`modules`** (1): `SLPackage` - **`moral-capacitor`** (19): `SLMachineMoralGate`, `SLMoralCapacitor`, `SLMoralCertificate`, `SLMoralCertificateAuthority`, `SLMoralCertified`, `SLMoralCharge`, `SLMoralCodeGuard`, `SLMoralFramework`, `SLMoralLedger`, `SLMoralOperation`, `SLMoralPolicy`, `SLMoralVerdict`, `SLMoralVeto`, `SLMoralWarranty`, `SLOSMoralGate`, `SLPackage`, `SLVMMoralGuard`, `moral-capacitor`, `moral-certificate` - **`munction`** (1): `SLPackage` - **`native`** (1): `SLPackage` - **`net`** (8): `SLDnsResolver`, `SLEndpoint`, `SLHttpRequest`, `SLHttpResponse`, `SLSocket`, `SLTcpConnection`, `SLUdpSocket`, `SLUri` - **`nordshrift`** (11): `DynamiteConnector`, `MySQLConnector`, `NordshriftCompilerBridge`, `NordshriftSource`, `NordshriftSymbol`, `NordshriftSymbolResolver`, `NordshriftSymbolTable`, `PermissibleConnector`, `PostgreSQLConnector`, `SLPackage`, `SQLConnector` - **`opcodes`** — 171 classes (facade `opcodes.SLGovConcept`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`os`** — 85 classes (facade `os.SLArchitectureSet`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`politico`** (1): `SLPackage` - **`process`** (16): `SLAtomic`, `SLBarrier`, `SLCondition`, `SLExecutor`, `SLMutex`, `SLProcessBuilder`, `SLProcessEnvironment`, `SLProcessGroup`, `SLProcessHandle`, `SLProcessInfo`, `SLProcessScheduler`, `SLProcessSignal`, `SLSemaphore`, `SLThreadGroup`, `SLThreadLocal`, `SLThreadState` - **`psychiatry`** (1): `SLPackage` - **`public`** (1): `SLPackage` - **`reflection`** (16): `SLAnnotation`, `SLAnnotationValue`, `SLClassLoader`, `SLClassRegistry`, `SLConstructorInfo`, `SLFieldInfo`, `SLGenericParameter`, `SLGenericType`, `SLInheritance`, `SLInterface`, `SLInterfaceRegistry`, `SLMethodInfo`, `SLParameterInfo`, `SLReflection`, `SLType`, `SLTypeInfo` - **`regex`** (27): `Regex`, `RegexCapability`, `RegexCapture`, `RegexCompiler`, `RegexDialect`, `RegexEngine`, `RegexError`, `RegexFlags`, `RegexIterator`, `RegexLiteral`, `RegexMatch`, `RegexMatcher`, `RegexNatural`, `RegexNaturalGrammar`, `RegexNaturalGroup`, `RegexNaturalParser`, `RegexNaturalSymbol`, `RegexOptions`, `RegexPattern`, `RegexReplacement`, `RegexReplacer`, `RegexResult`, `RegexScanner`, `RegexSplitter`, `RegexSubject`, `RegexSystem`, `RegexValidator` - **`rmi`** (1): `SLPackage` - **`runtime`** (16): `SLCallFrame`, `SLCallStack`, `SLConstantPool`, `SLException`, `SLExceptionHandler`, `SLGarbageCollector`, `SLGlobalTable`, `SLInstruction`, `SLLocalTable`, `SLObjectFactory`, `SLOpcode`, `SLOperand`, `SLOperandStack`, `SLRuntime`, `SLRuntimeConfig`, `SLRuntimeState` - **`security`** (6): `SLCapability`, `SLCredential`, `SLHash`, `SLPermission`, `SLRandom`, `SLSecureBuffer` - **`server-edition`** (1): `SLPackage` - **`sldocument`** (9): `SLDocument`, `SLDocumentAnnotation`, `SLDocumentCompiler`, `SLDocumentConverter`, `SLDocumentNaming`, `SLDocumentResult`, `SLDocumentStep`, `SLSourceNameComparison`, `SLVeritable` - **`sleela`** (1): `SLPackage` - **`sleela-terminal`** (1): `SLPackage` - **`social-model`** (1): `SLPackage` - **`sst`** (11): `DynamiteConnector`, `MySQLConnector`, `PostgreSQLConnector`, `SLPackage`, `SQLConnector`, `SSTLibrary`, `SSTSource`, `SSTSymbol`, `SSTSymbolKind`, `SSTSymbolReference`, `SSTSymbolTable` - **`synchro`** (1): `SLPackage` - **`systems`** (1): `SLPackage` - **`telephony-skya`** (7): `Communication`, `Network`, `RealAcquaintances`, `SLPackage`, `Servers`, `SkyaModules`, `Socio` - **`terminal`** (1): `SLPackage` - **`terminal_pixel`** (1): `SLPackage` - **`text`** (8): `SLCharset`, `SLFormatter`, `SLRegex`, `SLString`, `SLStringBuffer`, `SLStringBuilder`, `SLTextReader`, `SLTextWriter` - **`ui`** (16): `SLApplication`, `SLButton`, `SLDialog`, `SLLabel`, `SLLayout`, `SLListView`, `SLMenu`, `SLMenuItem`, `SLTableView`, `SLTextArea`, `SLTextField`, `SLTheme`, `SLTreeView`, `SLView`, `SLWidget`, `SLWindow` - **`us-infrastructure`** (1): `SLPackage` - **`user-interface`** — 53 classes (facade `user-interface.SLPackage`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`video`** (21): `Video`, `VideoCodec`, `VideoCodecCatalog`, `VideoCodecController`, `VideoCodecLoader`, `VideoCodecProcessor`, `VideoCodecVerifier`, `VideoDecoder`, `VideoEncoder`, `VideoFormat`, `VideoFrame`, `VideoFrameBuffer`, `VideoPixelFormat`, `VideoProfile`, `VideoRenderer`, `VideoStream`, `VideoTimeline`, `VideoTimestamp`, `VideoTrack`, `VideoWork`, `video-codec-pipeline` - **`vm`** — 85 classes (facade `vm.GCBarrier`); see `lib/LIBRARY.SYMBOLS.md` for the full list. - **`website`** — 50 classes (facade `website.AerLingusWebsite`); see `lib/LIBRARY.SYMBOLS.md` for the full list.