SST Symbol Contract
NS-SST-0001 — SST Symbol Resolution Contract
An SST class or other named declaration is a compiler symbol, not merely text metadata.
Identity
The canonical identity is <package>.<symbol>.
Examples: sst.SLPackage, sst.SSTSymbol, nordshrift.NordshriftSymbol, vm.SleelaVMCompilerManager.
Short names are never sufficient for cross-package resolution.
Lifecycle
declared -> resolved -> emitted
A declaration that cannot resolve remains unresolved and is a compile diagnostic. An ambiguous reference is never silently selected.
Authority
The canonical filesystem-backed /lib collection and sleela::library::Index are authoritative. SST does not maintain a second package or symbol registry.
Symbol kinds
The normative kinds are: class, interface, function, field, constant, variable, module, package, type.
Compile path
.sst -> SST symbol table -> Nordshrift resolver -> /lib Index -> Nordshrift symbol table -> .sleela -> SLeeLa compiler
The SLeeLa classes in /lib/sst and /lib/nordshrift are the source-level contracts; impl/nordshrift/sst_symbol.* is the native resolution boundary.
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.
<!-- GENERATED by tools/generate-vocab-appendix.py from lib/LIBRARY.SYMBOLS.md. Do not edit by hand; re-run the tool. -->
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 <package>.<ClassName>. 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,Themeantivirus(15):Antivirus,SLClamAVAdapter,SLDebianAntivirusProfile,SLFedoraAntivirusProfile,SLLocalScanner,SLMacOSAntivirusProfile,SLPackage,SLQuarantineManager,SLScanPolicy,SLScanRequest,SLScanResult,SLScannerEngine,SLSystemScanner,SLUbuntuAntivirusProfile,SLWindowsAntivirusProfileapi(1):SLPackageaudio(1):SLPackageautocad(5):SLCadDxf,SLCadModel,SLCadPlan,SLCadRenderer,autocadbash(1):SLPackageboolean— 270 classes (facadeboolean.SLPackage); seelib/LIBRARY.SYMBOLS.mdfor the full list.character(15):AdvertisingModel,BrokerageModel,BusinessModel,Character,ConsultingModel,FranchiseModel,FreemiumModel,LicensingModel,ManufacturingModel,MarketplaceModel,RetailModel,SLPackage,SaaSModel,SubscriptionModel,WholesaleModelchurn(1):SLPackagecitizen(19):AdvertisingModel,BankAccount,BrokerageModel,BusinessModel,Character,Citizen,ConsultingModel,FederalReserveID,FranchiseModel,FreemiumModel,Industry,LicensingModel,ManufacturingModel,MarketplaceModel,RetailModel,SLPackage,SaaSModel,SubscriptionModel,WholesaleModelcodecs(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,codecscollections(8):SLArray,SLIterator,SLList,SLMap,SLQueue,SLRange,SLSet,SLStackcommon-rails(12):PrintComponent,PrintContractTest,PrintField,PrintFormatter,PrintGlyphs,PrintLayout,PrintLine,PrintProgress,PrintRenderer,PrintState,PrintWriter,SLPackagecompiler— 54 classes (facadecompiler.BinaryFormatReference); seelib/LIBRARY.SYMBOLS.mdfor the full list.config(1):SLPackageconnector(1):SLPackagecoorenagraph(20):Amoral,Beneficence,Coorenagraph,Deontology,Ethics,Magnanimous,Moral,MoralDeliberation,MoralVocabulary,Morale,Morals,Pernicious,Principled,Probity,Reprobate,SLPackage,Unscrupulous,Upright,Utilitarianism,VirtueEthicscore— 84 classes (facadecore.SLPackage); seelib/LIBRARY.SYMBOLS.mdfor the full list.cpu— 140 classes (facadecpu.SL6502CPU); seelib/LIBRARY.SYMBOLS.mdfor 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,SLVerifierdata(1):SLPackagedata-structures(9):DSList,DSMap,DSObject,DSQueue,DSStack,DSValue,DataStructures,DataStructuresTest,SLPackagedatabase(16):SLColumn,SLConnectionPool,SLDataSource,SLDatabase,SLDatabaseConfig,SLIndex,SLMigration,SLPreparedStatement,SLQuery,SLQueryParameter,SLResultSet,SLRow,SLSchema,SLStatement,SLTable,SLTransactiondebugger(16):SLBreakpoint,SLCoverage,SLDebugFrame,SLDebugSession,SLDebugTarget,SLDebugValue,SLDebugger,SLExceptionPoint,SLExecutionPoint,SLProfiler,SLSourceMap,SLStackTrace,SLStepController,SLTraceBuffer,SLTraceEvent,SLWatchpointdecompiler(13):BinaryFormatReference,DecompilerModule,FractionalInput,LanguageReference,OSDiscernment,OutputTarget,ProgramMapping,SLPackage,SafetyReference,SleelaDecompiler,SourceLanguage,artifact-analysis,fractional-reconstructiondeliberation— 295 classes (facadedeliberation.SLAStarSearch); seelib/LIBRARY.SYMBOLS.mdfor the full list.drivers(1):SLPackagefilesystem(16):SLArchive,SLDirectoryInfo,SLDirectoryReader,SLDirectoryWalker,SLFileAttributes,SLFileCopier,SLFileInfo,SLFileLock,SLFileMode,SLFileMover,SLFilePermissions,SLFileReader,SLFileWatcher,SLFileWriter,SLPathPattern,SLPathResolvergameplay(14):AskForHelpMove,DetailedReport,DiceRoll,ExpectedFuture,GameMove,GameTurn,HelpIndexMove,InferenceEngine,ManagementCourtroom,MoveOutcome,NewDesireMove,Player,PortfolioDecision,SLPackagegui(11):SLGuiAction,SLGuiBackend,SLGuiBridge,SLGuiDocument,SLGuiDocumentListener,SLGuiHost,SLGuiIntegration,SLGuiRuntime,SLGuiWindow,SLPackage,gui-demohtml(1):SLPackagehttp(17):SLHttpBody,SLHttpCache,SLHttpClient,SLHttpCookie,SLHttpHandler,SLHttpHeaders,SLHttpMiddleware,SLHttpMultipart,SLHttpProxy,SLHttpRoute,SLHttpRouter,SLHttpServer,SLHttpSession,SLHttpStatus,SLHttpTls,SLHttpVersion,SLRouteDatahttp-1.0(1):SLPackagehttp-2.0(1):SLPackagehttp-3.0(1):SLPackagehttp-4.0(1):SLPackagehttp-5.0(1):SLPackagehttp-6.0(1):SLPackagehttp-7.0(1):SLPackagehttp-8.0(1):SLPackagehttp-9.0(1):SLPackagehttp-servers(1):SLPackageide(1):SLPackageinference-model(1):SLPackageinputs(1):SLPackageinternational-criminal-court(1):SLPackageio(8):SLBufferedInput,SLBufferedOutput,SLByteStream,SLConsole,SLFileStream,SLInputStream,SLMemoryStream,SLOutputStreamjava— 8982 classes (facadejava.SLPackage); seelib/LIBRARY.SYMBOLS.mdfor the full list.java28(1):SLPackagejourney(1):SLPackagelanguages(4):SLLanguage,SLLanguageCatalog,SLLanguageSettings,languagesledger(1):SLPackagemanifesto(1):SLPackagemath— 243 classes (facademath.SLANOVA); seelib/LIBRARY.SYMBOLS.mdfor the full list.memory(16):SLAddress,SLAllocator,SLArena,SLBuffer,SLByteBuffer,SLMemory,SLMemoryBlock,SLMemoryManager,SLMemoryRegion,SLMemorySegment,SLMemoryStatistics,SLMemoryView,SLPointer,SLPoolAllocator,SLReference,SLWeakReferencemodules(1):SLPackagemoral-capacitor(19):SLMachineMoralGate,SLMoralCapacitor,SLMoralCertificate,SLMoralCertificateAuthority,SLMoralCertified,SLMoralCharge,SLMoralCodeGuard,SLMoralFramework,SLMoralLedger,SLMoralOperation,SLMoralPolicy,SLMoralVerdict,SLMoralVeto,SLMoralWarranty,SLOSMoralGate,SLPackage,SLVMMoralGuard,moral-capacitor,moral-certificatemunction(1):SLPackagenative(1):SLPackagenet(8):SLDnsResolver,SLEndpoint,SLHttpRequest,SLHttpResponse,SLSocket,SLTcpConnection,SLUdpSocket,SLUrinordshrift(11):DynamiteConnector,MySQLConnector,NordshriftCompilerBridge,NordshriftSource,NordshriftSymbol,NordshriftSymbolResolver,NordshriftSymbolTable,PermissibleConnector,PostgreSQLConnector,SLPackage,SQLConnectoropcodes— 171 classes (facadeopcodes.SLGovConcept); seelib/LIBRARY.SYMBOLS.mdfor the full list.os— 85 classes (facadeos.SLArchitectureSet); seelib/LIBRARY.SYMBOLS.mdfor the full list.politico(1):SLPackageprocess(16):SLAtomic,SLBarrier,SLCondition,SLExecutor,SLMutex,SLProcessBuilder,SLProcessEnvironment,SLProcessGroup,SLProcessHandle,SLProcessInfo,SLProcessScheduler,SLProcessSignal,SLSemaphore,SLThreadGroup,SLThreadLocal,SLThreadStatepsychiatry(1):SLPackagepublic(1):SLPackagereflection(16):SLAnnotation,SLAnnotationValue,SLClassLoader,SLClassRegistry,SLConstructorInfo,SLFieldInfo,SLGenericParameter,SLGenericType,SLInheritance,SLInterface,SLInterfaceRegistry,SLMethodInfo,SLParameterInfo,SLReflection,SLType,SLTypeInforegex(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,RegexValidatorrmi(1):SLPackageruntime(16):SLCallFrame,SLCallStack,SLConstantPool,SLException,SLExceptionHandler,SLGarbageCollector,SLGlobalTable,SLInstruction,SLLocalTable,SLObjectFactory,SLOpcode,SLOperand,SLOperandStack,SLRuntime,SLRuntimeConfig,SLRuntimeStatesecurity(6):SLCapability,SLCredential,SLHash,SLPermission,SLRandom,SLSecureBufferserver-edition(1):SLPackagesldocument(9):SLDocument,SLDocumentAnnotation,SLDocumentCompiler,SLDocumentConverter,SLDocumentNaming,SLDocumentResult,SLDocumentStep,SLSourceNameComparison,SLVeritablesleela(1):SLPackagesleela-terminal(1):SLPackagesocial-model(1):SLPackagesst(11):DynamiteConnector,MySQLConnector,PostgreSQLConnector,SLPackage,SQLConnector,SSTLibrary,SSTSource,SSTSymbol,SSTSymbolKind,SSTSymbolReference,SSTSymbolTablesynchro(1):SLPackagesystems(1):SLPackagetelephony-skya(7):Communication,Network,RealAcquaintances,SLPackage,Servers,SkyaModules,Socioterminal(1):SLPackageterminal_pixel(1):SLPackagetext(8):SLCharset,SLFormatter,SLRegex,SLString,SLStringBuffer,SLStringBuilder,SLTextReader,SLTextWriterui(16):SLApplication,SLButton,SLDialog,SLLabel,SLLayout,SLListView,SLMenu,SLMenuItem,SLTableView,SLTextArea,SLTextField,SLTheme,SLTreeView,SLView,SLWidget,SLWindowus-infrastructure(1):SLPackageuser-interface— 53 classes (facadeuser-interface.SLPackage); seelib/LIBRARY.SYMBOLS.mdfor 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-pipelinevm— 85 classes (facadevm.GCBarrier); seelib/LIBRARY.SYMBOLS.mdfor the full list.website— 50 classes (facadewebsite.AerLingusWebsite); seelib/LIBRARY.SYMBOLS.mdfor the full list.