@duckcodeailabs/dql-core 0.1.3 → 0.2.0

package/dist/semantic/index.d.ts

@@ -1,4 +1,5 @@
 export { SemanticAnalyzer, analyze } from './analyzer.js';
 export { SemanticLayer, parseMetricDefinition, parseDimensionDefinition, parseHierarchyDefinition, parseBlockCompanionDefinition, parseCubeDefinition, } from './semantic-layer.js';
 export type { MetricDefinition, DimensionDefinition, HierarchyDefinition, BlockCompanionDefinition, HierarchyLevelDefinition, HierarchyDrillPathDefinition, HierarchyRollupType, SemanticLayerConfig, JoinDefinition, TimeDimensionDefinition, CubeDefinition, ComposeQueryOptions, ComposeQueryResult, } from './semantic-layer.js';
+export { loadSemanticLayerFromDir, loadSemanticLayerFromConfig, } from './yaml-loader.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/semantic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/semantic/index.js

@@ -1,3 +1,4 @@
 export { SemanticAnalyzer, analyze } from './analyzer.js';
 export { SemanticLayer, parseMetricDefinition, parseDimensionDefinition, parseHierarchyDefinition, parseBlockCompanionDefinition, parseCubeDefinition, } from './semantic-layer.js';
+export { loadSemanticLayerFromDir, loadSemanticLayerFromConfig, } from './yaml-loader.js';
 //# sourceMappingURL=index.js.map

package/dist/semantic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAgB7B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/semantic/yaml-loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * YAML-based semantic layer loader.
+ * Reads metric, dimension, hierarchy, cube, and block-companion YAML files
+ * from a project's semantic-layer/ directory and returns a populated SemanticLayer.
+ */
+import { SemanticLayer } from './semantic-layer.js';
+/**
+ * Load a SemanticLayer from a directory on disk.
+ * Expected structure:
+ *   semanticLayerDir/
+ *     metrics/       → *.yaml metric definitions
+ *     dimensions/    → *.yaml dimension definitions
+ *     hierarchies/   → *.yaml hierarchy definitions
+ *     cubes/         → *.yaml cube definitions
+ *     blocks/        → *.yaml block companion definitions (metadata only, not loaded into layer)
+ */
+export declare function loadSemanticLayerFromDir(semanticLayerDir: string): SemanticLayer;
+/**
+ * Load a SemanticLayer from pre-read file contents (no filesystem access needed).
+ * Useful for browser contexts or when files are already loaded.
+ */
+export declare function loadSemanticLayerFromConfig(files: Array<{
+    path: string;
+    content: string;
+}>): SemanticLayer;
+//# sourceMappingURL=yaml-loader.d.ts.map

package/dist/semantic/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"","sources":["../../src/semantic/yaml-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,aAAa,EAKd,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,aAAa,CA4BhF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,aAAa,CAwBf"}

package/dist/semantic/yaml-loader.js

@@ -0,0 +1,80 @@
+/**
+ * YAML-based semantic layer loader.
+ * Reads metric, dimension, hierarchy, cube, and block-companion YAML files
+ * from a project's semantic-layer/ directory and returns a populated SemanticLayer.
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import * as yaml from 'js-yaml';
+import { SemanticLayer, parseMetricDefinition, parseDimensionDefinition, parseHierarchyDefinition, parseCubeDefinition, } from './semantic-layer.js';
+/**
+ * Load a SemanticLayer from a directory on disk.
+ * Expected structure:
+ *   semanticLayerDir/
+ *     metrics/       → *.yaml metric definitions
+ *     dimensions/    → *.yaml dimension definitions
+ *     hierarchies/   → *.yaml hierarchy definitions
+ *     cubes/         → *.yaml cube definitions
+ *     blocks/        → *.yaml block companion definitions (metadata only, not loaded into layer)
+ */
+export function loadSemanticLayerFromDir(semanticLayerDir) {
+    const layer = new SemanticLayer();
+    const subdirs = [
+        { folder: 'metrics', loader: (raw) => layer.addMetric(parseMetricDefinition(raw)) },
+        { folder: 'dimensions', loader: (raw) => layer.addDimension(parseDimensionDefinition(raw)) },
+        { folder: 'hierarchies', loader: (raw) => layer.addHierarchy(parseHierarchyDefinition(raw)) },
+        { folder: 'cubes', loader: (raw) => layer.addCube(parseCubeDefinition(raw)) },
+    ];
+    for (const { folder, loader } of subdirs) {
+        const dir = join(semanticLayerDir, folder);
+        if (!existsSync(dir))
+            continue;
+        for (const file of readdirSync(dir)) {
+            if (extname(file) !== '.yaml' && extname(file) !== '.yml')
+                continue;
+            try {
+                const content = readFileSync(join(dir, file), 'utf-8');
+                const raw = yaml.load(content);
+                if (raw && typeof raw === 'object') {
+                    loader(raw);
+                }
+            }
+            catch {
+                // Skip malformed YAML files
+            }
+        }
+    }
+    return layer;
+}
+/**
+ * Load a SemanticLayer from pre-read file contents (no filesystem access needed).
+ * Useful for browser contexts or when files are already loaded.
+ */
+export function loadSemanticLayerFromConfig(files) {
+    const layer = new SemanticLayer();
+    for (const file of files) {
+        try {
+            const raw = yaml.load(file.content);
+            if (!raw || typeof raw !== 'object')
+                continue;
+            const pathLower = file.path.toLowerCase();
+            if (pathLower.includes('/metrics/') || pathLower.includes('\\metrics\\')) {
+                layer.addMetric(parseMetricDefinition(raw));
+            }
+            else if (pathLower.includes('/dimensions/') || pathLower.includes('\\dimensions\\')) {
+                layer.addDimension(parseDimensionDefinition(raw));
+            }
+            else if (pathLower.includes('/hierarchies/') || pathLower.includes('\\hierarchies\\')) {
+                layer.addHierarchy(parseHierarchyDefinition(raw));
+            }
+            else if (pathLower.includes('/cubes/') || pathLower.includes('\\cubes\\')) {
+                layer.addCube(parseCubeDefinition(raw));
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    return layer;
+}
+//# sourceMappingURL=yaml-loader.js.map

package/dist/semantic/yaml-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.js","sourceRoot":"","sources":["../../src/semantic/yaml-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,gBAAwB;IAC/D,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAElC,MAAM,OAAO,GAA8E;QACzF,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE;QACnF,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,EAAE;QAC5F,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,EAAE;QAC7F,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE;KAC9E,CAAC;IAEF,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM;gBAAE,SAAS;YACpE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBACvD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAA4B,CAAC;gBAC1D,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA+C;IAE/C,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAA4B,CAAC;YAC/D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACtF,KAAK,CAAC,YAAY,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxF,KAAK,CAAC,YAAY,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5E,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-core",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "DQL language core: lexer, parser, AST, semantic analysis",
   "license": "Apache-2.0",
   "type": "module",
@@ -33,13 +33,17 @@
     "access": "public"
   },
   "devDependencies": {
-    "vitest": "^3.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
-    "@types/node": "^22.0.0"
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
+  "dependencies": {
+    "js-yaml": "^4.1.1"
+  },
   "scripts": {
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
     "test": "vitest run",