@domainlang/language 0.5.2 → 0.7.0

package/out/services/semver.d.ts

@@ -1,98 +0,0 @@
-/**
- * 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

@@ -1,195 +0,0 @@
-/**
- * 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

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

package/src/lsp/hover/ddd-pattern-explanations.ts

@@ -1,237 +0,0 @@
-/**
- * DDD Pattern Explanations for Hover Documentation
- * 
- * Provides plain-English explanations for DDD integration patterns,
- * relationship types, and decision categories.
- */
-
-/**
- * Explanations for DDD integration role patterns (e.g., PL, ACL, SK).
- */
-export const rolePatternExplanations: Record<string, string> = {
-    'PL': `**Published Language (PL)**
-
-The upstream context provides a well-documented, stable API/model that downstream contexts consume.
-
-\`\`\`domain-lang
-[PL] UpstreamContext -> DownstreamContext
-\`\`\`
-
-*Use when:* Multiple consumers need a shared, stable interface.`,
-    
-    'ACL': `**Anti-Corruption Layer (ACL)**
-
-Protects downstream from upstream changes by translating between models.
-
-\`\`\`domain-lang
-UpstreamContext -> [ACL] DownstreamContext
-\`\`\`
-
-*Use when:* You don't trust upstream stability or want isolation.`,
-    
-    'SK': `**Shared Kernel (SK)**
-
-Both contexts share common domain model code requiring coordination.
-
-\`\`\`domain-lang
-[SK] Context1 <-> [SK] Context2 : SharedKernel
-\`\`\`
-
-*Use when:* Contexts are tightly coupled and teams can coordinate.`,
-    
-    'CF': `**Conformist (CF)**
-
-Downstream accepts upstream model without translation.
-
-\`\`\`domain-lang
-UpstreamContext -> [CF] DownstreamContext
-\`\`\`
-
-*Use when:* Upstream model is acceptable and translation isn't worth it.`,
-    
-    'OHS': `**Open Host Service (OHS)**
-
-Upstream defines a protocol/API for easy integration.
-
-\`\`\`domain-lang
-[OHS, PL] ApiContext -> ConsumerContext
-\`\`\`
-
-*Use when:* Multiple downstream contexts need integration.`,
-    
-    'P': `**Partnership (P)**
-
-Teams coordinate development and align releases.
-
-\`\`\`domain-lang
-Context1 <-> Context2 : Partnership
-\`\`\`
-
-*Use when:* Mutual success dependency exists.`,
-    
-    'BBoM': `**Big Ball of Mud (BBoM)**
-
-No clear boundaries - tangled models needing refactoring.
-
-\`\`\`domain-lang
-[BBoM] LegacySystem -> ModernContext
-\`\`\`
-
-*Use when:* Documenting legacy systems.`
-};
-
-/**
- * Explanations for relationship types (e.g., Partnership, CustomerSupplier).
- */
-export const relationshipTypeExplanations: Record<string, string> = {
-    'Partnership': '**Partnership**\n\nTwo contexts with mutual success dependency. Teams plan together and coordinate releases.\n\n*Example:* Sales and Order Fulfillment contexts that must evolve in sync.',
-    
-    'SharedKernel': '**Shared Kernel**\n\nTwo contexts share a subset of code/model. Changes require agreement from both teams.\n\n*Example:* Two closely related contexts sharing common domain entities.',
-    
-    'CustomerSupplier': '**Customer/Supplier**\n\nDownstream (customer) context depends on upstream (supplier) context. Supplier meets customer\'s needs through negotiation.\n\n*Example:* Payment context (customer) depends on Billing context (supplier).',
-    
-    'UpstreamDownstream': '**Upstream/Downstream**\n\nUpstream context influences downstream context, but not vice versa. Downstream adapts to upstream changes.\n\n*Example:* Inventory (upstream) provides data to Reporting (downstream).',
-    
-    'SeparateWays': '**Separate Ways**\n\nNo connection between contexts - they duplicate functionality rather than integrate.\n\n*Use when:* Integration cost exceeds benefit of sharing.'
-};
-
-/**
- * Explanations for relationship arrows.
- */
-export const arrowExplanations: Record<string, string> = {
-    '<->': 'Bidirectional relationship - both contexts influence each other',
-    '->': 'Downstream dependency - right depends on left (left is upstream)',
-    '<-': 'Upstream dependency - left depends on right (right is upstream)',
-    '><': 'Separate Ways - no integration between contexts',
-    'U/D': 'Upstream/Downstream - shorthand for upstream → downstream flow',
-    'u/d': 'Upstream/Downstream - shorthand for upstream → downstream flow',
-    'C/S': 'Customer/Supplier - shorthand for customer ← supplier relationship',
-    'c/s': 'Customer/Supplier - shorthand for customer ← supplier relationship'
-};
-
-/**
- * Explanations for decision categories.
- */
-export const decisionCategoryExplanations: Record<string, string> = {
-    'architectural': '**Architectural Decision**\n\nConcerns system structure, technology choices, or cross-cutting patterns.\n\n*Examples:* Microservices vs monolith, event sourcing, CQRS',
-    'arch': 'Short for "architectural" - concerns system structure and technology choices',
-    
-    'business': '**Business Decision**\n\nConcerns business rules, policies, or domain logic.\n\n*Examples:* Pricing rules, refund policies, eligibility criteria',
-    'biz': 'Short for "business" - concerns business rules and domain logic',
-    
-    'technical': '**Technical Decision**\n\nConcerns implementation details, algorithms, or technical constraints.\n\n*Examples:* Caching strategy, data structures, optimization approach',
-    'tech': 'Short for "technical" - concerns implementation details',
-    
-    'compliance': '**Compliance Decision**\n\nConcerns legal, regulatory, or compliance requirements.\n\n*Examples:* GDPR data retention, SOX audit trails, HIPAA privacy',
-    
-    'security': '**Security Decision**\n\nConcerns security, authentication, authorization, or data protection.\n\n*Examples:* OAuth vs JWT, encryption at rest, access control',
-    
-    'operational': '**Operational Decision**\n\nConcerns deployment, monitoring, or operational procedures.\n\n*Examples:* Blue/green deployment, monitoring strategy, backup policy',
-    'ops': 'Short for "operational" - concerns deployment and operations'
-};
-
-/**
- * Explanations for common DDD classifications.
- */
-export const classificationExplanations: Record<string, string> = {
-    'Core': '**Core Domain**\n\nThe primary differentiator for your business - this is where you create unique value.\n\n*Invest heavily:* Best team, careful design, deep modeling.\n\n*Example:* Recommendation engine for Netflix, search for Google',
-    
-    'Supporting': '**Supporting Subdomain**\n\nNecessary for the business but not a differentiator. Custom implementation needed but not the main focus.\n\n*Invest moderately:* Good team, solid implementation.\n\n*Example:* Inventory management, invoicing',
-    
-    'Generic': '**Generic Subdomain**\n\nSolved problem - could use off-the-shelf solution. No competitive advantage.\n\n*Buy or reuse:* Use existing solutions when possible.\n\n*Example:* User authentication, email sending, payment processing',
-    
-    'Strategic': '**Strategic** (Wardley Evolution)\n\nNovel, custom-built, competitive advantage. High value, low maturity.\n\n*Similar to Core Domain.*',
-    
-    'Custom': '**Custom-Built** (Wardley Evolution)\n\nSpecialized solution, some precedent exists. Medium-high value, medium maturity.',
-    
-    'Product': '**Product/Rental** (Wardley Evolution)\n\nStandardized product with features. Medium value, medium-high maturity.\n\n*Example:* SaaS tools, commercial software',
-    
-    'Commodity': '**Commodity/Utility** (Wardley Evolution)\n\nUbiquitous, interchangeable, fully standardized. Low value, high maturity.\n\n*Example:* Cloud compute, email services'
-};
-
-/**
- * Get explanation for a role pattern.
- */
-export function explainRolePattern(role: string): string | undefined {
-    return rolePatternExplanations[role];
-}
-
-/**
- * Get explanation for a relationship type.
- */
-export function explainRelationshipType(type: string): string | undefined {
-    return relationshipTypeExplanations[type];
-}
-
-/**
- * Get explanation for an arrow symbol.
- */
-export function explainArrow(arrow: string): string | undefined {
-    return arrowExplanations[arrow];
-}
-
-/**
- * Get explanation for a decision category.
- */
-export function explainDecisionCategory(category: string): string | undefined {
-    return decisionCategoryExplanations[category];
-}
-
-/**
- * Get explanation for a classification.
- */
-export function explainClassification(name: string): string | undefined {
-    return classificationExplanations[name];
-}
-
-/**
- * Generate relationship explanation from roles and type.
- */
-export function generateRelationshipExplanation(
-    leftRoles: string[] | undefined,
-    arrow: string | undefined,
-    rightRoles: string[] | undefined,
-    type: string | undefined
-): string {
-    const parts: string[] = [];
-    
-    // Arrow explanation
-    if (arrow) {
-        const arrowExp = explainArrow(arrow);
-        if (arrowExp) {
-            parts.push(`**Arrow:** ${arrowExp}`);
-        }
-    }
-    
-    // Left roles
-    if (leftRoles && leftRoles.length > 0) {
-        parts.push('**Left Context Patterns:**');
-        leftRoles.forEach(role => {
-            const exp = explainRolePattern(role);
-            if (exp) {
-                parts.push(exp);
-            }
-        });
-    }
-    
-    // Right roles
-    if (rightRoles && rightRoles.length > 0) {
-        parts.push('**Right Context Patterns:**');
-        rightRoles.forEach(role => {
-            const exp = explainRolePattern(role);
-            if (exp) {
-                parts.push(exp);
-            }
-        });
-    }
-    
-    // Relationship type
-    if (type) {
-        const typeExp = explainRelationshipType(type);
-        if (typeExp) {
-            parts.push(typeExp);
-        }
-    }
-    
-    return parts.join('\n\n---\n\n');
-}