@digital-alchemy/symbols 26.6.20

package/CLAUDE.md

@@ -0,0 +1,41 @@
+# CLAUDE.md — @digital-alchemy/symbols
+
+## 1. What this is
+
+`@digital-alchemy/symbols` is the declaration-merge interface registry for
+`@digital-alchemy/core`. It is **types-only** and **zero-dependency**: the entire
+surface is `src/index.mts`, which exports a set of interfaces. Each interface is a
+stable identity that downstream libraries augment via TypeScript declaration
+merging. It is intentionally minimal.
+
+The build emits `dist/index.d.mts` (the type surface consumers resolve) and
+`dist/index.mjs` (an effectively empty runtime module).
+
+## 2. Augment via core, not this package
+
+Consumers augment these interfaces through `declare module "@digital-alchemy/core"`
+— `core` re-exports the symbols so every merge lands on one shared identity:
+
+```typescript
+declare module "@digital-alchemy/core" {
+  interface LoadedModules {
+    utils: typeof LIB_UTILS;
+  }
+}
+```
+
+## 3. Tooling
+
+House style matches `@digital-alchemy/core`: yarn 4.16.0 (`nodeLinker:
+node-modules`), Node `>=20`, `tsc` with `module/moduleResolution` nodenext-class
+(`ESNext` / `Bundler`), strict-ish compiler options, ESLint flat config, prettier
+(`printWidth: 100`, double quotes, trailing commas), cspell. Versioning follows
+core's CalVer auto-bump (`bump-version.yml`) on release.
+
+- `yarn build` — `rm -rf dist/` then `tsc -p tsconfig.lib.json` (emits both
+  `.d.mts` and `.mjs`).
+- `yarn lint` — `eslint src`.
+- `yarn type-check` — `tsc -p tsconfig.json --noEmit`.
+
+Each script appends `&& echo "✓ <scriptname> passed"` so silent tools print a
+visible success line on exit 0.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 zoe-codez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+[![version](https://img.shields.io/npm/v/@digital-alchemy/symbols)](https://www.npmjs.com/package/@digital-alchemy/symbols)
+
+---
+<div align="center">
+
+![Digital Alchemy](https://raw.githubusercontent.com/Digital-Alchemy-TS/.github/main/profile/github-logo.png)
+
+</div>
+
+## Install
+
+```bash
+yarn add -D @digital-alchemy/symbols
+```
+
+## What it is
+
+`@digital-alchemy/symbols` is the declaration-merge interface registry for
+[`@digital-alchemy/core`](https://github.com/Digital-Alchemy-TS/core). It is a
+types-only, zero-dependency package that ships a set of TypeScript interfaces —
+`LoadedModules`, `LoadedRollups`, `AsyncLogData`, `AsyncLocalData`, `IsIt`,
+`DeclaredEnvironments`, `ConfigLoaderSource`, `ReplacementLogger`,
+`AbstractConfig`, and `BaseConfig`. These are the stable identities that
+downstream `@digital-alchemy` libraries augment to wire themselves into `core` at
+the type level. It is intentionally minimal.
+
+## Augment `@digital-alchemy/core`, not this package
+
+You augment these interfaces through `@digital-alchemy/core`, which re-exports
+them so every merge lands on a single shared identity:
+
+```typescript
+export const LIB_UTILS = CreateLibrary({
+  name: "utils",
+  services: { fetch: FetchUtils },
+});
+
+declare module "@digital-alchemy/core" {
+  interface LoadedModules {
+    utils: typeof LIB_UTILS;
+  }
+}
+```
+
+## Questions / Issues?
+
+[![discord](https://img.shields.io/discord/1219758743848489147?label=Discord&logo=discord)](https://discord.gg/JkZ35Gv97Y)

package/dist/index.d.mts

@@ -0,0 +1,47 @@
+/**
+ * `@digital-alchemy/symbols` — the declaration-merge interface registry for
+ * `@digital-alchemy/core`.
+ *
+ * Each export is a stable interface identity that downstream libraries augment
+ * via `declare module "@digital-alchemy/core"` (core re-exports these symbols, so
+ * the merges land on a single shared identity). It is intentionally minimal.
+ *
+ * @packageDocumentation
+ */
+/** Registry of modules loaded into a running application; augment via `@digital-alchemy/core`. */
+export interface LoadedModules {
+}
+/** Registry of rollup groupings exposed by loaded modules; augment via `@digital-alchemy/core`. */
+export interface LoadedRollups {
+}
+/** Per-context async log data merged into every log line; augment via `@digital-alchemy/core`. */
+export interface AsyncLogData {
+    duration?: () => number;
+}
+/** Per-context async-local storage payload; augment via `@digital-alchemy/core`. */
+export interface AsyncLocalData {
+}
+/** The type-guard / predicate surface (`is`); augment via `@digital-alchemy/core`. */
+export interface IsIt {
+}
+/** Set of declared runtime environments; augment via `@digital-alchemy/core`. */
+export interface DeclaredEnvironments {
+    prod: true;
+    test: true;
+    local: true;
+}
+/** Set of config-loader source channels; augment via `@digital-alchemy/core`. */
+export interface ConfigLoaderSource {
+    argv: true;
+    env: true;
+    file: true;
+}
+/** The replacement-logger surface; augment via `@digital-alchemy/core`. */
+export interface ReplacementLogger {
+}
+/** The global config hierarchy; augment via `@digital-alchemy/core`. */
+export interface AbstractConfig {
+}
+/** The base config block shared by every module; augment via `@digital-alchemy/core`. */
+export interface BaseConfig {
+}

package/dist/index.mjs

@@ -0,0 +1,12 @@
+/**
+ * `@digital-alchemy/symbols` — the declaration-merge interface registry for
+ * `@digital-alchemy/core`.
+ *
+ * Each export is a stable interface identity that downstream libraries augment
+ * via `declare module "@digital-alchemy/core"` (core re-exports these symbols, so
+ * the merges land on a single shared identity). It is intentionally minimal.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "type": "module",
+  "name": "@digital-alchemy/symbols",
+  "description": "Declaration-merge interface registry for @digital-alchemy/core — types-only, zero-dependency",
+  "repository": {
+    "url": "git+https://github.com/Digital-Alchemy-TS/symbols"
+  },
+  "version": "26.6.20",
+  "author": {
+    "url": "https://github.com/zoe-codez",
+    "name": "Zoe Codez"
+  },
+  "types": "dist/index.d.mts",
+  "homepage": "https://docs.digital-alchemy.app",
+  "scripts": {
+    "build": "rm -rf dist/; tsc -p tsconfig.lib.json && echo \"✓ build passed\"",
+    "lint": "eslint src && echo \"✓ lint passed\"",
+    "type-check": "tsc -p tsconfig.json --noEmit && echo \"✓ type-check passed\""
+  },
+  "bugs": {
+    "email": "bugs@digital-alchemy.app",
+    "url": "https://github.com/Digital-Alchemy-TS/symbols/issues/new/choose"
+  },
+  "keywords": [
+    "nodejs",
+    "typescript",
+    "types",
+    "declaration-merging",
+    "digital-alchemy"
+  ],
+  "funding": [
+    {
+      "url": "https://github.com/sponsors/zoe-codez",
+      "type": "GitHub"
+    }
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "CLAUDE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@cspell/eslint-plugin": "^10.0.1",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.9.3",
+    "@typescript-eslint/eslint-plugin": "8.61.0",
+    "@typescript-eslint/parser": "8.61.0",
+    "eslint": "10.5.0",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsonc": "^3.2.0",
+    "eslint-plugin-no-unsanitized": "^4.1.5",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-security": "^4.0.1",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
+    "eslint-plugin-sonarjs": "^4.0.3",
+    "eslint-plugin-sort-keys-fix": "^1.1.2",
+    "eslint-plugin-unicorn": "^65.0.1",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.4",
+    "tslib": "^2.8.1",
+    "typescript": "^6.0.3"
+  },
+  "packageManager": "yarn@4.16.0"
+}