@domainlang/language 0.1.82 → 0.4.0

package/out/services/import-resolver.js

@@ -1,16 +1,224 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { URI } from 'langium';
 /**
- * ImportResolver resolves import statements using WorkspaceManager and GitUrlResolver.
+ * ImportResolver resolves import statements using manifest-centric rules (PRS-010).
+ *
+ * Import Types (PRS-010):
+ * - Local relative: ./path, ../path → Directory-first resolution
+ * - Path aliases: @/path, @alias/path → Configurable in model.yaml paths section
+ * - External: owner/package → Manifest dependencies
+ *
+ * Directory-First Resolution:
+ * - ./types → ./types/index.dlang → ./types.dlang
+ * - Module entry defaults to index.dlang (no model.yaml required)
  */
 export class ImportResolver {
     constructor(services) {
         this.workspaceManager = services.imports.WorkspaceManager;
     }
     /**
-     * Resolve an import URL to a file URI using the workspace's GitUrlResolver.
+     * Resolve an import specifier relative to a Langium document.
      */
-    async resolveImport(importUrl) {
-        const gitResolver = await this.workspaceManager.getGitResolver();
-        return gitResolver.resolve(importUrl);
+    async resolveForDocument(document, specifier) {
+        const baseDir = path.dirname(document.uri.fsPath);
+        return this.resolveFrom(baseDir, specifier);
+    }
+    /**
+     * Resolve an import specifier from a base directory (non-LSP contexts).
+     */
+    async resolveFrom(baseDir, specifier) {
+        await this.workspaceManager.initialize(baseDir);
+        // Local relative paths (./path or ../path) - directory-first resolution
+        if (specifier.startsWith('./') || specifier.startsWith('../')) {
+            const resolved = path.resolve(baseDir, specifier);
+            return this.resolveLocalPath(resolved, specifier);
+        }
+        // Path aliases (@/path or @alias/path)
+        if (specifier.startsWith('@')) {
+            return this.resolvePathAlias(specifier);
+        }
+        // External dependency via manifest (owner/package format)
+        return this.resolveExternalDependency(specifier);
+    }
+    /**
+     * Resolves a path alias import.
+     *
+     * @param specifier - Import specifier starting with @ (e.g., "@/lib", "@shared/types")
+     */
+    async resolvePathAlias(specifier) {
+        const aliases = await this.workspaceManager.getPathAliases();
+        const root = this.workspaceManager.getWorkspaceRoot();
+        // Find matching alias
+        const aliasMatch = this.findMatchingAlias(specifier, aliases);
+        if (aliasMatch) {
+            const { alias: _alias, targetPath, remainder } = aliasMatch;
+            const manifestPath = await this.workspaceManager.getManifestPath();
+            const manifestDir = manifestPath ? path.dirname(manifestPath) : root;
+            const resolvedBase = path.resolve(manifestDir, targetPath);
+            const resolved = remainder ? path.join(resolvedBase, remainder) : resolvedBase;
+            return this.resolveLocalPath(resolved, specifier);
+        }
+        // Default: @/ maps to workspace root (implicit)
+        if (specifier.startsWith('@/')) {
+            const relativePath = specifier.slice(2);
+            const resolved = path.join(root, relativePath);
+            return this.resolveLocalPath(resolved, specifier);
+        }
+        throw new Error(`Unknown path alias '${specifier.split('/')[0]}' in import '${specifier}'.\n` +
+            `Hint: Define it in model.yaml paths section:\n` +
+            `  paths:\n` +
+            `    "${specifier.split('/')[0]}": "./some/path"`);
+    }
+    /**
+     * Finds the longest matching alias for a specifier.
+     */
+    findMatchingAlias(specifier, aliases) {
+        if (!aliases) {
+            return undefined;
+        }
+        // Sort by length descending to match most specific alias first
+        const sortedAliases = Object.entries(aliases)
+            .sort(([a], [b]) => b.length - a.length);
+        for (const [alias, targetPath] of sortedAliases) {
+            // Exact match
+            if (specifier === alias) {
+                return { alias, targetPath, remainder: '' };
+            }
+            // Prefix match (alias + /)
+            if (specifier.startsWith(`${alias}/`)) {
+                return { alias, targetPath, remainder: specifier.slice(alias.length + 1) };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Resolves an external dependency via manifest.
+     *
+     * NEW FORMAT (PRS-010): Import specifier is owner/package format.
+     */
+    async resolveExternalDependency(specifier) {
+        const manifest = await this.workspaceManager.getManifest();
+        if (!manifest) {
+            throw new Error(`External dependency '${specifier}' requires model.yaml.\n` +
+                `Hint: Create model.yaml and add the dependency:\n` +
+                `  dependencies:\n` +
+                `    ${specifier}:\n` +
+                `      ref: v1.0.0`);
+        }
+        const lock = await this.workspaceManager.getLockFile();
+        if (!lock) {
+            throw new Error(`Dependency '${specifier}' not installed.\n` +
+                `Hint: Run 'dlang install' to fetch dependencies and generate model.lock.`);
+        }
+        const mapped = await this.workspaceManager.resolveDependencyImport(specifier);
+        if (!mapped) {
+            throw new Error(`Dependency '${specifier}' not found in model.yaml.\n` +
+                `Hint: Add it to your dependencies:\n` +
+                `  dependencies:\n` +
+                `    ${specifier}:\n` +
+                `      ref: v1.0.0`);
+        }
+        const git = await this.workspaceManager.getGitResolver();
+        return git.resolve(mapped, { allowNetwork: false });
+    }
+    /**
+     * Resolves a local path using directory-first resolution.
+     *
+     * Per PRS-010 (updated design):
+     * - If path ends with .dlang → direct file import
+     * - If no extension → directory-first:
+     *   1. Try ./path/index.dlang (module default, no model.yaml required)
+     *   2. Try ./path.dlang (file fallback)
+     */
+    async resolveLocalPath(resolved, original) {
+        const ext = path.extname(resolved);
+        if (ext === '.dlang') {
+            // Direct file import
+            await assertFileExists(resolved, original);
+            return URI.file(resolved);
+        }
+        if (ext && ext !== '.dlang') {
+            throw new Error(`Invalid file extension '${ext}' in import '${original}'.\n` +
+                `Hint: DomainLang files must use the .dlang extension.`);
+        }
+        // No extension → directory-first resolution
+        return this.resolveDirectoryFirst(resolved, original);
+    }
+    /**
+     * Directory-first resolution: ./types → ./types/index.dlang → ./types.dlang
+     *
+     * Module entry defaults to index.dlang without requiring model.yaml.
+     * If the directory has model.yaml with custom entry, use that.
+     */
+    async resolveDirectoryFirst(resolved, original) {
+        // Step 1: Check if directory exists with index.dlang (or custom entry)
+        const isDirectory = await this.isDirectory(resolved);
+        if (isDirectory) {
+            // Check for model.yaml to get custom entry point
+            const moduleManifestPath = path.join(resolved, 'model.yaml');
+            const entryPoint = await this.readModuleEntry(moduleManifestPath);
+            const entryFile = path.join(resolved, entryPoint);
+            if (await this.fileExists(entryFile)) {
+                return URI.file(entryFile);
+            }
+            // Directory exists but no entry file
+            throw new Error(`Module '${original}' is missing its entry file.\n` +
+                `Expected: ${resolved}/${entryPoint}\n` +
+                `Hint: Create '${entryPoint}' in the module directory, or specify a custom entry in model.yaml:\n` +
+                `  model:\n` +
+                `    entry: main.dlang`);
+        }
+        // Step 2: Try .dlang file fallback
+        const fileWithExt = `${resolved}.dlang`;
+        if (await this.fileExists(fileWithExt)) {
+            return URI.file(fileWithExt);
+        }
+        // Neither directory nor file found
+        throw new Error(`Cannot resolve import '${original}'.\n` +
+            `Tried:\n` +
+            `  • ${resolved}/index.dlang (directory module)\n` +
+            `  • ${resolved}.dlang (file)\n` +
+            `Hint: Check that the path is correct and the file exists.`);
+    }
+    /**
+     * Reads the entry point from a module's model.yaml.
+     * Defaults to index.dlang if no manifest or no entry specified.
+     */
+    async readModuleEntry(manifestPath) {
+        try {
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            const YAML = await import('yaml');
+            const manifest = YAML.parse(content);
+            return manifest?.model?.entry ?? 'index.dlang';
+        }
+        catch {
+            return 'index.dlang';
+        }
+    }
+    /**
+     * Checks if a path is a directory.
+     */
+    async isDirectory(targetPath) {
+        try {
+            const stat = await fs.stat(targetPath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks if a file exists.
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
     }
     /**
      * Get the current lock file (if loaded).
@@ -19,4 +227,14 @@ export class ImportResolver {
         return this.workspaceManager.getLockFile();
     }
 }
+async function assertFileExists(filePath, original) {
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        throw new Error(`Import file not found: '${original}'.\\n` +
+            `Resolved path: ${filePath}\\n` +
+            `Hint: Check that the file exists and the path is correct.`);
+    }
+}
 //# sourceMappingURL=import-resolver.js.map

package/out/services/import-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-resolver.js","sourceRoot":"","sources":["../../src/services/import-resolver.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,cAAc;IAGvB,YAAY,QAA4B;QACpC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACjC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC;QACjE,OAAO,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC/C,CAAC;CACJ"}
+{"version":3,"file":"import-resolver.js","sourceRoot":"","sources":["../../src/services/import-resolver.ts"],"names":[],"mappings":"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"}

package/out/services/performance-optimizer.d.ts

@@ -7,7 +7,7 @@
  * - Cache warming strategies
  * - Stale cache detection
  */
-import type { LockFile } from './git-url-resolver.js';
+import type { LockFile } from './types.js';
 /**
  * Performance optimizer with in-memory caching.
  */

package/out/services/semver.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Semantic Versioning Utilities
+ *
+ * Centralized SemVer parsing, comparison, and validation for the dependency system.
+ * All version-related logic should use these utilities to ensure consistency.
+ *
+ * Supported formats:
+ * - "1.0.0" or "v1.0.0" (tags)
+ * - "1.0.0-alpha.1" (pre-release)
+ * - "main", "develop" (branches)
+ * - "abc123def" (commit SHAs, 7-40 hex chars)
+ */
+import type { SemVer, RefType, ParsedRef } from './types.js';
+/**
+ * Parses a version string into SemVer components.
+ * Returns undefined if not a valid SemVer.
+ *
+ * @example
+ * parseSemVer("v1.2.3")       // { major: 1, minor: 2, patch: 3, original: "v1.2.3" }
+ * parseSemVer("1.0.0-alpha")  // { major: 1, minor: 0, patch: 0, prerelease: "alpha", ... }
+ * parseSemVer("main")         // undefined (not SemVer)
+ */
+export declare function parseSemVer(version: string): SemVer | undefined;
+/**
+ * Detects the type of a git ref based on its format.
+ *
+ * @example
+ * detectRefType("v1.0.0")    // 'tag'
+ * detectRefType("1.2.3")     // 'tag'
+ * detectRefType("main")      // 'branch'
+ * detectRefType("abc123def") // 'commit'
+ */
+export declare function detectRefType(ref: string): RefType;
+/**
+ * Parses a ref string into a structured ParsedRef with type and optional SemVer.
+ */
+export declare function parseRef(ref: string): ParsedRef;
+/**
+ * Compares two SemVer versions.
+ * Returns: negative if a < b, positive if a > b, zero if equal.
+ *
+ * @example
+ * compareSemVer(parse("1.0.0"), parse("2.0.0")) // negative (a < b)
+ * compareSemVer(parse("1.5.0"), parse("1.2.0")) // positive (a > b)
+ * compareSemVer(parse("1.0.0-alpha"), parse("1.0.0")) // negative (prerelease < release)
+ */
+export declare function compareSemVer(a: SemVer, b: SemVer): number;
+/**
+ * Picks the latest from a list of SemVer refs.
+ * Returns the ref string (with original 'v' prefix if present).
+ *
+ * @example
+ * pickLatestSemVer(["v1.0.0", "v1.5.0", "v1.2.0"]) // "v1.5.0"
+ */
+export declare function pickLatestSemVer(refs: string[]): string | undefined;
+/**
+ * Sorts version strings in descending order (newest first).
+ * Non-SemVer refs are sorted lexicographically at the end.
+ *
+ * @example
+ * sortVersionsDescending(["v1.0.0", "v2.0.0", "v1.5.0"]) // ["v2.0.0", "v1.5.0", "v1.0.0"]
+ */
+export declare function sortVersionsDescending(versions: string[]): string[];
+/**
+ * Checks if a version/ref is a pre-release.
+ *
+ * Pre-release identifiers: alpha, beta, rc, pre, dev, snapshot
+ *
+ * @example
+ * isPreRelease("v1.0.0")       // false
+ * isPreRelease("v1.0.0-alpha") // true
+ * isPreRelease("v1.0.0-rc.1")  // true
+ */
+export declare function isPreRelease(ref: string): boolean;
+/**
+ * Checks if two SemVer versions are compatible (same major version).
+ *
+ * @example
+ * areSameMajor(parse("1.0.0"), parse("1.5.0")) // true
+ * areSameMajor(parse("1.0.0"), parse("2.0.0")) // false
+ */
+export declare function areSameMajor(a: SemVer, b: SemVer): boolean;
+/**
+ * Gets the major version number from a ref string.
+ * Returns undefined if not a valid SemVer.
+ */
+export declare function getMajorVersion(ref: string): number | undefined;
+/**
+ * Filters refs to only stable versions (excludes pre-releases).
+ *
+ * @example
+ * filterStableVersions(["v1.0.0", "v1.1.0-alpha", "v1.2.0"]) // ["v1.0.0", "v1.2.0"]
+ */
+export declare function filterStableVersions(refs: string[]): string[];
+/**
+ * Filters refs to only SemVer tags (excludes branches and commits).
+ */
+export declare function filterSemVerTags(refs: string[]): string[];

package/out/services/semver.js

@@ -0,0 +1,195 @@
+/**
+ * Semantic Versioning Utilities
+ *
+ * Centralized SemVer parsing, comparison, and validation for the dependency system.
+ * All version-related logic should use these utilities to ensure consistency.
+ *
+ * Supported formats:
+ * - "1.0.0" or "v1.0.0" (tags)
+ * - "1.0.0-alpha.1" (pre-release)
+ * - "main", "develop" (branches)
+ * - "abc123def" (commit SHAs, 7-40 hex chars)
+ */
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parses a version string into SemVer components.
+ * Returns undefined if not a valid SemVer.
+ *
+ * @example
+ * parseSemVer("v1.2.3")       // { major: 1, minor: 2, patch: 3, original: "v1.2.3" }
+ * parseSemVer("1.0.0-alpha")  // { major: 1, minor: 0, patch: 0, prerelease: "alpha", ... }
+ * parseSemVer("main")         // undefined (not SemVer)
+ */
+export function parseSemVer(version) {
+    // Strip leading 'v' if present
+    const normalized = version.startsWith('v') ? version.slice(1) : version;
+    // Match semver pattern: major.minor.patch[-prerelease]
+    const match = normalized.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+    if (!match)
+        return undefined;
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+        preRelease: match[4],
+        original: version,
+    };
+}
+/**
+ * Detects the type of a git ref based on its format.
+ *
+ * @example
+ * detectRefType("v1.0.0")    // 'tag'
+ * detectRefType("1.2.3")     // 'tag'
+ * detectRefType("main")      // 'branch'
+ * detectRefType("abc123def") // 'commit'
+ */
+export function detectRefType(ref) {
+    // Commit SHA: 7-40 hex characters
+    if (/^[0-9a-f]{7,40}$/i.test(ref)) {
+        return 'commit';
+    }
+    // Tags typically start with 'v' followed by semver
+    if (/^v?\d+\.\d+\.\d+/.test(ref)) {
+        return 'tag';
+    }
+    // Everything else is treated as a branch
+    return 'branch';
+}
+/**
+ * Parses a ref string into a structured ParsedRef with type and optional SemVer.
+ */
+export function parseRef(ref) {
+    const type = detectRefType(ref);
+    const semver = type === 'tag' ? parseSemVer(ref) : undefined;
+    return { original: ref, type, semver };
+}
+// ============================================================================
+// Comparison
+// ============================================================================
+/**
+ * Compares two SemVer versions.
+ * Returns: negative if a < b, positive if a > b, zero if equal.
+ *
+ * @example
+ * compareSemVer(parse("1.0.0"), parse("2.0.0")) // negative (a < b)
+ * compareSemVer(parse("1.5.0"), parse("1.2.0")) // positive (a > b)
+ * compareSemVer(parse("1.0.0-alpha"), parse("1.0.0")) // negative (prerelease < release)
+ */
+export function compareSemVer(a, b) {
+    if (a.major !== b.major)
+        return a.major - b.major;
+    if (a.minor !== b.minor)
+        return a.minor - b.minor;
+    if (a.patch !== b.patch)
+        return a.patch - b.patch;
+    // Pre-release versions are lower than release versions
+    if (a.preRelease && !b.preRelease)
+        return -1;
+    if (!a.preRelease && b.preRelease)
+        return 1;
+    if (a.preRelease && b.preRelease) {
+        return a.preRelease.localeCompare(b.preRelease);
+    }
+    return 0;
+}
+/**
+ * Picks the latest from a list of SemVer refs.
+ * Returns the ref string (with original 'v' prefix if present).
+ *
+ * @example
+ * pickLatestSemVer(["v1.0.0", "v1.5.0", "v1.2.0"]) // "v1.5.0"
+ */
+export function pickLatestSemVer(refs) {
+    const parsed = refs
+        .map(ref => ({ ref, semver: parseSemVer(ref) }))
+        .filter((item) => item.semver !== undefined);
+    if (parsed.length === 0)
+        return undefined;
+    parsed.sort((a, b) => compareSemVer(b.semver, a.semver)); // Descending
+    return parsed[0].ref;
+}
+/**
+ * Sorts version strings in descending order (newest first).
+ * Non-SemVer refs are sorted lexicographically at the end.
+ *
+ * @example
+ * sortVersionsDescending(["v1.0.0", "v2.0.0", "v1.5.0"]) // ["v2.0.0", "v1.5.0", "v1.0.0"]
+ */
+export function sortVersionsDescending(versions) {
+    return [...versions].sort((a, b) => {
+        const semverA = parseSemVer(a);
+        const semverB = parseSemVer(b);
+        // Both are SemVer - compare semantically
+        if (semverA && semverB) {
+            return compareSemVer(semverB, semverA); // Descending
+        }
+        // SemVer comes before non-SemVer
+        if (semverA && !semverB)
+            return -1;
+        if (!semverA && semverB)
+            return 1;
+        // Both non-SemVer - lexicographic
+        return b.localeCompare(a);
+    });
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Checks if a version/ref is a pre-release.
+ *
+ * Pre-release identifiers: alpha, beta, rc, pre, dev, snapshot
+ *
+ * @example
+ * isPreRelease("v1.0.0")       // false
+ * isPreRelease("v1.0.0-alpha") // true
+ * isPreRelease("v1.0.0-rc.1")  // true
+ */
+export function isPreRelease(ref) {
+    const semver = parseSemVer(ref);
+    if (semver?.preRelease) {
+        return true;
+    }
+    // Also check for common pre-release patterns without proper SemVer
+    const clean = ref.replace(/^v/, '');
+    return /-(alpha|beta|rc|pre|dev|snapshot)/i.test(clean);
+}
+/**
+ * Checks if two SemVer versions are compatible (same major version).
+ *
+ * @example
+ * areSameMajor(parse("1.0.0"), parse("1.5.0")) // true
+ * areSameMajor(parse("1.0.0"), parse("2.0.0")) // false
+ */
+export function areSameMajor(a, b) {
+    return a.major === b.major;
+}
+/**
+ * Gets the major version number from a ref string.
+ * Returns undefined if not a valid SemVer.
+ */
+export function getMajorVersion(ref) {
+    return parseSemVer(ref)?.major;
+}
+// ============================================================================
+// Filtering
+// ============================================================================
+/**
+ * Filters refs to only stable versions (excludes pre-releases).
+ *
+ * @example
+ * filterStableVersions(["v1.0.0", "v1.1.0-alpha", "v1.2.0"]) // ["v1.0.0", "v1.2.0"]
+ */
+export function filterStableVersions(refs) {
+    return refs.filter(ref => !isPreRelease(ref));
+}
+/**
+ * Filters refs to only SemVer tags (excludes branches and commits).
+ */
+export function filterSemVerTags(refs) {
+    return refs.filter(ref => detectRefType(ref) === 'tag' && parseSemVer(ref) !== undefined);
+}
+//# sourceMappingURL=semver.js.map

package/out/services/semver.js.map

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