@no22/dison 1.0.0

package/dist/runtime.js

@@ -0,0 +1,79 @@
+// =====================================================================
+// 共有ランタイムの前置き生成
+// =====================================================================
+// ランタイムの宣言部分（DI_REGISTRY/TYPE_BINDINGS/bindType/resolveType/
+// registerOverride/getOverride）を生成する。exportKeyword に "export " を渡すと
+// 各宣言がexportされる（複数ファイルで共有するランタイムモジュールとして使う
+// 場合）。単一ファイルでインライン生成する場合は ""（空文字）を渡す。
+//
+// DI_REGISTRY（override用）はクラス名の文字列ではなく、クラスの実体そのものを
+// キーにする（WeakMap<Function, ...>）。理由:
+//   - override対象のクラス名が実際にスコープ内に存在するか（importし忘れ・
+//     タイプミスがないか）をtsc自身が「名前が見つからない」エラーとして
+//     検出できるようになる（従来は文字列一致だったため、タイプミスしても
+//     一切検出されずDI_REGISTRY["Typo"]という誰も参照しないエントリを
+//     静かに作るだけだった）。
+//   - 複数ファイルにまたがって同名クラスが存在しても、参照そのものが
+//     キーになるため衝突しない（docs/multi-file-support.md参照）。
+//
+// TYPE_BINDINGS（bind用）は従来通り型名の文字列でキー化する。bindの左辺は
+// interface/型エイリアスもあり得るが、これらは実行時に値を持たないため
+// DI_REGISTRYと同じ手法（実体参照でのキー化）が使えない。複数ファイルに
+// またがるinterface/型エイリアスの名前衝突は未解決の課題として残る
+// （docs/multi-file-support.md 3.4節）。
+export function generateRuntimeDeclarations(exportKeyword) {
+    return (`// Global dependency registry (per-property override).\n` +
+        `// Keying on the class itself (not its name) lets tsc catch a typo in the\n` +
+        `// override target class name as a "Cannot find name" error.\n` +
+        `${exportKeyword}const DI_REGISTRY = new WeakMap<Function, Record<string, () => any>>();\n\n` +
+        `${exportKeyword}function registerOverride(cls: Function, prop: string, factory: () => any): void {\n` +
+        `  let entry = DI_REGISTRY.get(cls);\n` +
+        `  if (!entry) {\n` +
+        `    entry = {};\n` +
+        `    DI_REGISTRY.set(cls, entry);\n` +
+        `  }\n` +
+        `  entry[prop] = factory;\n` +
+        `}\n\n` +
+        `${exportKeyword}function getOverride(cls: Function, prop: string): (() => any) | undefined {\n` +
+        `  return DI_REGISTRY.get(cls)?.[prop];\n` +
+        `}\n\n` +
+        `// Global type-replacement registry (bind).\n` +
+        `// The key is either a type-name string (class, interface, or type alias name)\n` +
+        `// or a Symbol explicitly given via an "as <token>" clause (used to avoid\n` +
+        `// name collisions between same-named interfaces/type aliases across files).\n` +
+        `${exportKeyword}const TYPE_BINDINGS = new Map<string | symbol, () => any>();\n` +
+        `const _resolvingTypeBindings = new Set<string | symbol>();\n\n` +
+        `// bindType<T> takes T as an explicit type argument, so tsc raises a\n` +
+        `// compile error if the replacement factory isn't compatible with the\n` +
+        `// original type. T may be an interface or type alias (used only as a\n` +
+        `// type argument).\n` +
+        `${exportKeyword}function bindType<T>(typeKey: string | symbol, factory: () => T): void {\n` +
+        `  TYPE_BINDINGS.set(typeKey, factory);\n` +
+        `}\n\n` +
+        `// Resolves a value by recursively walking TYPE_BINDINGS. bind chains\n` +
+        `// (e.g. bind A = B; bind B = C; makes resolving A eventually reach C).\n` +
+        `// A cycle (A -> B -> A) raises a clear error instead of a stack overflow.\n` +
+        `${exportKeyword}function resolveType<T>(typeKey: string | symbol, defaultFactory: () => T): T {\n` +
+        `  const bound = TYPE_BINDINGS.get(typeKey);\n` +
+        `  if (!bound) return defaultFactory();\n` +
+        `  if (_resolvingTypeBindings.has(typeKey)) {\n` +
+        `    throw new Error('Detected a circular "bind" reference ("' + String(typeKey) + '"). The bind chain loops back on itself.');\n` +
+        `  }\n` +
+        `  _resolvingTypeBindings.add(typeKey);\n` +
+        `  try {\n` +
+        `    return bound();\n` +
+        `  } finally {\n` +
+        `    _resolvingTypeBindings.delete(typeKey);\n` +
+        `  }\n` +
+        `}\n`);
+}
+// 複数ファイルでランタイム状態（DI_REGISTRY/TYPE_BINDINGS）を共有するための
+// 共有ランタイムモジュールのソース。scripts/generate-runtime-module.tsが
+// これをsrc/generated-runtime.tsとして書き出し、tscがdist/にコンパイルする
+// ことで、"@no22/dison/runtime" として配布される（docs/packaging.md）。
+export const DISON_RUNTIME_MODULE_SOURCE = `// --- Dison shared runtime module ---\n` +
+    `// Multiple generated files import this module to share runtime state\n` +
+    `// such as DI_REGISTRY/TYPE_BINDINGS.\n` +
+    `// This file is auto-generated when the Dison package is built. Do not edit it by hand.\n\n` +
+    generateRuntimeDeclarations("export ");
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,gBAAgB;AAChB,wEAAwE;AAExE,6DAA6D;AAC7D,oEAAoE;AACpE,2CAA2C;AAC3C,sCAAsC;AACtC,EAAE;AACF,kDAAkD;AAClD,oCAAoC;AACpC,gDAAgD;AAChD,yCAAyC;AACzC,wCAAwC;AACxC,gDAAgD;AAChD,mBAAmB;AACnB,sCAAsC;AACtC,kDAAkD;AAClD,EAAE;AACF,iDAAiD;AACjD,0CAA0C;AAC1C,2CAA2C;AAC3C,wCAAwC;AACxC,qCAAqC;AACrC,MAAM,UAAU,2BAA2B,CAAC,aAA6B;IACvE,OAAO,CACL,0DAA0D;QAC1D,6EAA6E;QAC7E,gEAAgE;QAChE,GAAG,aAAa,6EAA6E;QAC7F,GAAG,aAAa,sFAAsF;QACtG,uCAAuC;QACvC,mBAAmB;QACnB,mBAAmB;QACnB,oCAAoC;QACpC,OAAO;QACP,4BAA4B;QAC5B,OAAO;QACP,GAAG,aAAa,gFAAgF;QAChG,0CAA0C;QAC1C,OAAO;QACP,+CAA+C;QAC/C,kFAAkF;QAClF,6EAA6E;QAC7E,gFAAgF;QAChF,GAAG,aAAa,gEAAgE;QAChF,gEAAgE;QAChE,wEAAwE;QACxE,yEAAyE;QACzE,yEAAyE;QACzE,sBAAsB;QACtB,GAAG,aAAa,4EAA4E;QAC5F,0CAA0C;QAC1C,OAAO;QACP,yEAAyE;QACzE,2EAA2E;QAC3E,8EAA8E;QAC9E,GAAG,aAAa,mFAAmF;QACnG,+CAA+C;QAC/C,0CAA0C;QAC1C,gDAAgD;QAChD,kIAAkI;QAClI,OAAO;QACP,0CAA0C;QAC1C,WAAW;QACX,uBAAuB;QACvB,iBAAiB;QACjB,+CAA+C;QAC/C,OAAO;QACP,KAAK,CACN,CAAC;AACJ,CAAC;AAED,oDAAoD;AACpD,uDAAuD;AACvD,uDAAuD;AACvD,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GACtC,0CAA0C;IAC1C,yEAAyE;IACzE,yCAAyC;IACzC,6FAA6F;IAC7F,2BAA2B,CAAC,SAAS,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@no22/dison",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "An experimental DSL that transpiles to TypeScript, with property injection built into the language itself.",
+  "main": "./dist/core.js",
+  "types": "./dist/core.d.ts",
+  "bin": {
+    "dison": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./runtime": {
+      "types": "./dist/generated-runtime.d.ts",
+      "default": "./dist/generated-runtime.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/no22/dison.git"
+  },
+  "homepage": "https://github.com/no22/dison#readme",
+  "bugs": {
+    "url": "https://github.com/no22/dison/issues"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsx scripts/generate-runtime-module.ts && tsc && chmod +x dist/cli.js",
+    "prepare": "npm run build",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "dependency-injection",
+    "dsl",
+    "transpiler",
+    "typescript"
+  ],
+  "author": "OHARA Hiroyuki",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}