tskb 0.0.1

package/dist/typescript/program.js

@@ -0,0 +1,84 @@
+import ts from "typescript";
+import path from "node:path";
+/**
+ * Creates a TypeScript Program from a list of files and a tsconfig.
+ *
+ * WHAT IS A TYPESCRIPT PROGRAM?
+ * It's TypeScript compiler's internal representation of your code:
+ * - Source files (parsed into AST)
+ * - Type checker (resolves types, finds symbols)
+ * - Compiler options (from tsconfig.json)
+ *
+ * WHY WE NEED IT:
+ * We're not compiling code, we're ANALYZING it. The TypeScript compiler
+ * API gives us tools to:
+ * 1. Parse .ts/.tsx files into syntax trees
+ * 2. Resolve types (what is Context<{...}>?)
+ * 3. Find symbols (where is "tskb" namespace defined?)
+ * 4. Walk ASTs to extract information
+ *
+ * THE PROCESS:
+ * 1. Read tsconfig.json using ts.readConfigFile
+ * 2. Parse it to get compiler options
+ * 3. Create a Program with our files + those options
+ * 4. Set noEmit=true because we're only reading, not compiling
+ *
+ * RESULT:
+ * A Program object we can query to extract registry and docs.
+ *
+ * @param files - Array of absolute file paths to analyze
+ * @param tsconfigPath - Path to tsconfig.json (for compiler options)
+ * @returns TypeScript Program ready for analysis
+ */
+export function createProgram(files, tsconfigPath) {
+    // Read and parse tsconfig.json to get compiler options
+    const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+    if (configFile.error) {
+        throw new Error(`Failed to read tsconfig: ${configFile.error.messageText}`);
+    }
+    const configParseResult = ts.parseJsonConfigFileContent(configFile.config, ts.sys, path.dirname(tsconfigPath));
+    if (configParseResult.errors.length > 0) {
+        const errorMessages = configParseResult.errors.map((err) => err.messageText).join("\n");
+        throw new Error(`Failed to parse tsconfig: ${errorMessages}`);
+    }
+    // Create compiler options, merging with our needs
+    const compilerOptions = {
+        ...configParseResult.options,
+        noEmit: true, // We don't need to emit JavaScript, just analyze the TypeScript AST
+    };
+    // Create the TypeScript Program
+    // This parses all files, builds the AST, and creates a type checker
+    const program = ts.createProgram({
+        rootNames: files,
+        options: compilerOptions,
+    });
+    // Check for TypeScript errors only in the specified files (not dependencies)
+    const fileSet = new Set(files.map((f) => path.normalize(f)));
+    const allDiagnostics = [
+        ...program.getSyntacticDiagnostics(),
+        ...program.getSemanticDiagnostics(),
+    ];
+    // Filter diagnostics to only include errors from the files we're analyzing
+    const diagnostics = allDiagnostics.filter((diagnostic) => {
+        if (!diagnostic.file)
+            return false;
+        return fileSet.has(path.normalize(diagnostic.file.fileName));
+    });
+    if (diagnostics.length > 0) {
+        const errorMessages = diagnostics
+            .map((diagnostic) => {
+            if (diagnostic.file) {
+                const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+                const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+                return `${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`;
+            }
+            else {
+                return ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+            }
+        })
+            .join("\n");
+        throw new Error(`TypeScript compilation errors:\n${errorMessages}`);
+    }
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/typescript/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/typescript/program.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "tskb",
+  "version": "0.0.1",
+  "description": "TS Knowledge Base. A TypeScript-native DSL for expressing architectural intent as typed declarations. Produces renderable docs/diagrams and a queryable knowledge graph, supporting type-checked snippet references, semantic relations, and constraints.",
+  "type": "module",
+  "bin": {
+    "tskb": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "pack:test": "npm run build && npm pack",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "echo \"Error: no test specified\" && exit 0"
+  },
+  "author": "Dimitar Mihaylov",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mitk0936/tskb.git"
+  },
+  "keywords": [
+    "typescript",
+    "documentation",
+    "architecture",
+    "knowledge-graph",
+    "docs-as-code",
+    "architecture-as-code",
+    "jsx",
+    "tsx",
+    "type-safe",
+    "compiler",
+    "validation",
+    "ai",
+    "graphviz",
+    "monorepo",
+    "diagrams",
+    "visualization",
+    "architectural-documentation",
+    "dsl",
+    "developer-tools",
+    "code-documentation",
+    "living-documentation",
+    "static-analysis",
+    "code-graph"
+  ],
+  "dependencies": {
+    "glob": "^13.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}