@domainlang/language 0.1.20

package/README.md

@@ -0,0 +1,163 @@
+# @domainlang/language
+
+[![npm version](https://img.shields.io/npm/v/@domainlang/language.svg)](https://www.npmjs.com/package/@domainlang/language)
+[![License](https://img.shields.io/npm/l/@domainlang/language.svg)](https://github.com/larsbaunwall/DomainLang/blob/main/LICENSE)
+
+Core language library for [DomainLang](https://github.com/larsbaunwall/DomainLang) - a Domain-Driven Design modeling language built with [Langium](https://langium.org/).
+
+## Features
+
+- 🔤 **Parser** - Full DomainLang grammar with error recovery
+- ✅ **Validation** - Semantic validation for DDD best practices
+- 🔗 **Linking** - Cross-reference resolution across files and packages
+- 🔍 **Model Query SDK** - Programmatic access to DDD models with fluent queries
+- 🌐 **Browser Support** - Works in Node.js and browser environments
+
+## Installation
+
+```bash
+npm install @domainlang/language
+```
+
+## Quick Start
+
+### Parse and Query Models
+
+```typescript
+import { loadModelFromText } from '@domainlang/language/sdk';
+
+const { query } = await loadModelFromText(`
+  Domain Sales {
+    vision: "Enable seamless commerce"
+  }
+  
+  bc OrderContext for Sales as Core by SalesTeam {
+    description: "Handles order lifecycle"
+  }
+`);
+
+// Query bounded contexts
+const coreContexts = query.boundedContexts()
+  .withRole('Core')
+  .toArray();
+
+console.log(coreContexts[0].name); // 'OrderContext'
+```
+
+### Load from File (Node.js)
+
+```typescript
+import { loadModel } from '@domainlang/language/sdk/loader-node';
+
+const { model, query } = await loadModel('./my-model.dlang');
+
+// Access domains
+for (const domain of query.domains()) {
+  console.log(`${domain.name}: ${domain.vision}`);
+}
+```
+
+## API Overview
+
+### Entry Points
+
+| Function | Environment | Use Case |
+| -------- | ----------- | -------- |
+| `loadModelFromText(text)` | Browser & Node | Parse inline DSL text |
+| `loadModel(file)` | Node.js only | Load from file system |
+| `fromDocument(doc)` | LSP integration | Zero-copy from Langium document |
+| `fromModel(model)` | Advanced | Direct AST wrapping |
+
+### Query Builder
+
+The SDK provides fluent query builders with lazy evaluation:
+
+```typescript
+// Find all bounded contexts owned by a team
+const teamContexts = query.boundedContexts()
+  .withTeam('PaymentsTeam')
+  .toArray();
+
+// Get context maps containing specific contexts
+const maps = query.contextMaps()
+  .containing('OrderContext')
+  .toArray();
+```
+
+### Direct Property Access
+
+```typescript
+// Direct AST properties
+const desc = boundedContext.description;
+const vision = domain.vision;
+
+// SDK-augmented properties (with precedence resolution)
+const role = boundedContext.effectiveRole;  // Header 'as' wins over body 'role:'
+const team = boundedContext.effectiveTeam;  // Header 'by' wins over body 'team:'
+```
+
+## DomainLang Syntax
+
+DomainLang models Domain-Driven Design concepts:
+
+```dlang
+// Define domains with vision
+Domain Sales {
+  vision: "Drive revenue through great customer experience"
+}
+
+// Bounded contexts with ownership
+bc OrderContext for Sales as Core by SalesTeam {
+  description: "Order lifecycle management"
+}
+
+bc PaymentContext for Sales as Supporting by PaymentsTeam
+
+// Context maps showing integrations
+ContextMap SalesIntegration {
+  contains OrderContext, PaymentContext
+  
+  [OHS,PL] OrderContext -> [CF] PaymentContext
+}
+```
+
+## Package Structure
+
+| Path | Purpose |
+| ---- | ------- |
+| `src/domain-lang.langium` | Grammar definition |
+| `src/generated/` | Auto-generated AST (do not edit) |
+| `src/validation/` | Semantic validation rules |
+| `src/lsp/` | LSP features (hover, completion, formatting) |
+| `src/sdk/` | Model Query SDK |
+
+## Related Packages
+
+- [@domainlang/cli](https://www.npmjs.com/package/@domainlang/cli) - Command-line interface
+- [DomainLang VS Code Extension](https://marketplace.visualstudio.com/items?itemName=thinkability.domain-lang) - IDE support
+
+## Documentation
+
+- [Getting Started](https://github.com/larsbaunwall/DomainLang/blob/main/dsl/domain-lang/docs/getting-started.md)
+- [Language Reference](https://github.com/larsbaunwall/DomainLang/blob/main/dsl/domain-lang/docs/language.md)
+- [Quick Reference](https://github.com/larsbaunwall/DomainLang/blob/main/dsl/domain-lang/docs/quick-reference.md)
+- [SDK Documentation](https://github.com/larsbaunwall/DomainLang/blob/main/dsl/domain-lang/packages/language/src/sdk/README.md)
+
+## Development
+
+From the workspace root (`dsl/domain-lang/`):
+
+```bash
+# After editing the grammar
+npm run langium:generate
+
+# Build this package
+npm run build --workspace packages/language
+
+# Run tests
+npm test --workspace packages/language
+```
+
+## License
+
+Apache-2.0

package/out/ast-augmentation.d.ts

@@ -0,0 +1,6 @@
+declare module './generated/ast.js' {
+    interface Relationship {
+        inferredType?: string;
+    }
+}
+export {};

package/out/ast-augmentation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast-augmentation.js.map

package/out/ast-augmentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-augmentation.js","sourceRoot":"","sources":["../src/ast-augmentation.ts"],"names":[],"mappings":""}

package/out/domain-lang-module.d.ts

@@ -0,0 +1,57 @@
+import { type Module } from 'langium';
+import type { DefaultSharedModuleContext, LangiumServices, LangiumSharedServices, PartialLangiumServices } from 'langium/lsp';
+import { QualifiedNameProvider } from './lsp/domain-lang-naming.js';
+import { DomainLangFormatter } from './lsp/domain-lang-formatter.js';
+import { DomainLangHoverProvider } from './lsp/hover/domain-lang-hover.js';
+import { DomainLangCompletionProvider } from './lsp/domain-lang-completion.js';
+import { DomainLangCodeActionProvider } from './lsp/domain-lang-code-actions.js';
+import { ImportResolver } from './services/import-resolver.js';
+import { WorkspaceManager } from './services/workspace-manager.js';
+/**
+ * Declaration of custom services - add your own service classes here.
+ */
+export type DomainLangAddedServices = {
+    imports: {
+        ImportResolver: ImportResolver;
+        WorkspaceManager: WorkspaceManager;
+    };
+    references: {
+        QualifiedNameProvider: QualifiedNameProvider;
+    };
+    lsp: {
+        Formatter: DomainLangFormatter;
+        HoverProvider: DomainLangHoverProvider;
+        CompletionProvider: DomainLangCompletionProvider;
+        CodeActionProvider: DomainLangCodeActionProvider;
+    };
+};
+/**
+ * Union of Langium default services and your custom services - use this as constructor parameter
+ * of custom service classes.
+ */
+export type DomainLangServices = LangiumServices & DomainLangAddedServices;
+/**
+ * Dependency injection module that overrides Langium default services and contributes the
+ * declared custom services. The Langium defaults can be partially specified to override only
+ * selected services, while the custom services must be fully specified.
+ */
+export declare const DomainLangModule: Module<DomainLangServices, PartialLangiumServices & DomainLangAddedServices>;
+/**
+ * Create the full set of services required by Langium.
+ *
+ * First inject the shared services by merging two modules:
+ *  - Langium default shared services
+ *  - Services generated by langium-cli
+ *
+ * Then inject the language-specific services by merging three modules:
+ *  - Langium default language-specific services
+ *  - Services generated by langium-cli
+ *  - Services specified in this file
+ *
+ * @param context Optional module context with the LSP connection
+ * @returns An object wrapping the shared services and the language-specific services
+ */
+export declare function createDomainLangServices(context: DefaultSharedModuleContext): {
+    shared: LangiumSharedServices;
+    DomainLang: DomainLangServices;
+};

package/out/domain-lang-module.js

@@ -0,0 +1,67 @@
+import { inject } from 'langium';
+import { createDefaultModule, createDefaultSharedModule } from 'langium/lsp';
+import { DomainLangGeneratedModule, DomainLangGeneratedSharedModule } from './generated/module.js';
+import { registerValidationChecks } from './validation/domain-lang-validator.js';
+import { QualifiedNameProvider } from './lsp/domain-lang-naming.js';
+import { DomainLangScopeComputation } from './lsp/domain-lang-scope.js';
+import { DomainLangFormatter } from './lsp/domain-lang-formatter.js';
+import { DomainLangHoverProvider } from './lsp/hover/domain-lang-hover.js';
+import { DomainLangCompletionProvider } from './lsp/domain-lang-completion.js';
+import { DomainLangCodeActionProvider } from './lsp/domain-lang-code-actions.js';
+import { ImportResolver } from './services/import-resolver.js';
+import { WorkspaceManager } from './services/workspace-manager.js';
+import { DomainLangWorkspaceManager } from './lsp/domain-lang-workspace-manager.js';
+const DomainLangSharedModule = {
+    workspace: {
+        WorkspaceManager: (services) => new DomainLangWorkspaceManager(services)
+    }
+};
+/**
+ * Dependency injection module that overrides Langium default services and contributes the
+ * declared custom services. The Langium defaults can be partially specified to override only
+ * selected services, while the custom services must be fully specified.
+ */
+export const DomainLangModule = {
+    imports: {
+        ImportResolver: (services) => new ImportResolver(services),
+        WorkspaceManager: () => new WorkspaceManager({ autoResolve: false, allowNetwork: false })
+    },
+    references: {
+        ScopeComputation: (services) => new DomainLangScopeComputation(services),
+        QualifiedNameProvider: () => new QualifiedNameProvider()
+    },
+    lsp: {
+        Formatter: () => new DomainLangFormatter(),
+        HoverProvider: (services) => new DomainLangHoverProvider(services),
+        CompletionProvider: (services) => new DomainLangCompletionProvider(services),
+        CodeActionProvider: () => new DomainLangCodeActionProvider()
+    },
+};
+/**
+ * Create the full set of services required by Langium.
+ *
+ * First inject the shared services by merging two modules:
+ *  - Langium default shared services
+ *  - Services generated by langium-cli
+ *
+ * Then inject the language-specific services by merging three modules:
+ *  - Langium default language-specific services
+ *  - Services generated by langium-cli
+ *  - Services specified in this file
+ *
+ * @param context Optional module context with the LSP connection
+ * @returns An object wrapping the shared services and the language-specific services
+ */
+export function createDomainLangServices(context) {
+    const shared = inject(createDefaultSharedModule(context), DomainLangGeneratedSharedModule, DomainLangSharedModule);
+    const DomainLang = inject(createDefaultModule({ shared }), DomainLangGeneratedModule, DomainLangModule);
+    shared.ServiceRegistry.register(DomainLang);
+    registerValidationChecks(DomainLang);
+    if (!context.connection) {
+        // We don't run inside a language server
+        // Therefore, initialize the configuration provider instantly
+        shared.workspace.ConfigurationProvider.initialized({});
+    }
+    return { shared, DomainLang };
+}
+//# sourceMappingURL=domain-lang-module.js.map

package/out/domain-lang-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-lang-module.js","sourceRoot":"","sources":["../src/domain-lang-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,EAAE,MAAM,SAAS,CAAC;AAQ9C,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AA2BpF,MAAM,sBAAsB,GAAgE;IACxF,SAAS,EAAE;QACP,gBAAgB,EAAE,CAAC,QAA+B,EAAE,EAAE,CAAC,IAAI,0BAA0B,CAAC,QAAQ,CAAC;KAClG;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiF;IAC1G,OAAO,EAAE;QACL,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC;QAC1D,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;KAC5F;IACD,UAAU,EAAE;QACR,gBAAgB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,0BAA0B,CAAC,QAAQ,CAAC;QACxE,qBAAqB,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE;KAC3D;IACD,GAAG,EAAE;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE;QAC1C,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC;QAClE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,4BAA4B,CAAC,QAAQ,CAAC;QAC5E,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE;KAC/D;CACJ,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAmC;IAIxE,MAAM,MAAM,GAAG,MAAM,CACjB,yBAAyB,CAAC,OAAO,CAAC,EAClC,+BAA+B,EAC/B,sBAAsB,CACzB,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,EAC/B,yBAAyB,EACzB,gBAAgB,CACnB,CAAC;IACF,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5C,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACtB,wCAAwC;QACxC,6DAA6D;QAC7D,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}