@agentix-e/nl2spel 0.0.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +69 -39
- package/dist/SpelEvaluator.d.ts +124 -0
- package/dist/SpelEvaluator.d.ts.map +1 -0
- package/dist/SpelEvaluator.js +2 -0
- package/dist/SpelEvaluator.js.map +1 -0
- package/dist/__tests__/auto-fixer.test.d.ts +2 -0
- package/dist/__tests__/auto-fixer.test.d.ts.map +1 -0
- package/dist/__tests__/auto-fixer.test.js +285 -0
- package/dist/__tests__/auto-fixer.test.js.map +1 -0
- package/dist/__tests__/chinese-number-parser.test.d.ts +2 -0
- package/dist/__tests__/chinese-number-parser.test.d.ts.map +1 -0
- package/dist/__tests__/chinese-number-parser.test.js +106 -0
- package/dist/__tests__/chinese-number-parser.test.js.map +1 -0
- package/dist/__tests__/context-extractor.test.d.ts +2 -0
- package/dist/__tests__/context-extractor.test.d.ts.map +1 -0
- package/dist/__tests__/context-extractor.test.js +347 -0
- package/dist/__tests__/context-extractor.test.js.map +1 -0
- package/dist/__tests__/coverage-gaps.test.d.ts +2 -0
- package/dist/__tests__/coverage-gaps.test.d.ts.map +1 -0
- package/dist/__tests__/coverage-gaps.test.js +578 -0
- package/dist/__tests__/coverage-gaps.test.js.map +1 -0
- package/dist/__tests__/intent-classifier.test.d.ts +2 -0
- package/dist/__tests__/intent-classifier.test.d.ts.map +1 -0
- package/dist/__tests__/intent-classifier.test.js +384 -0
- package/dist/__tests__/intent-classifier.test.js.map +1 -0
- package/dist/__tests__/nl2spel-engine.test.d.ts +2 -0
- package/dist/__tests__/nl2spel-engine.test.d.ts.map +1 -0
- package/dist/__tests__/nl2spel-engine.test.js +344 -0
- package/dist/__tests__/nl2spel-engine.test.js.map +1 -0
- package/dist/__tests__/pattern-matcher.test.d.ts +2 -0
- package/dist/__tests__/pattern-matcher.test.d.ts.map +1 -0
- package/dist/__tests__/pattern-matcher.test.js +754 -0
- package/dist/__tests__/pattern-matcher.test.js.map +1 -0
- package/dist/__tests__/prompt-builder.test.d.ts +2 -0
- package/dist/__tests__/prompt-builder.test.d.ts.map +1 -0
- package/dist/__tests__/prompt-builder.test.js +99 -0
- package/dist/__tests__/prompt-builder.test.js.map +1 -0
- package/dist/__tests__/provider-registry.test.d.ts +2 -0
- package/dist/__tests__/provider-registry.test.d.ts.map +1 -0
- package/dist/__tests__/provider-registry.test.js +240 -0
- package/dist/__tests__/provider-registry.test.js.map +1 -0
- package/dist/__tests__/schema-formatter.test.d.ts +2 -0
- package/dist/__tests__/schema-formatter.test.d.ts.map +1 -0
- package/dist/__tests__/schema-formatter.test.js +298 -0
- package/dist/__tests__/schema-formatter.test.js.map +1 -0
- package/dist/__tests__/self-correction-loop.test.d.ts +2 -0
- package/dist/__tests__/self-correction-loop.test.d.ts.map +1 -0
- package/dist/__tests__/self-correction-loop.test.js +253 -0
- package/dist/__tests__/self-correction-loop.test.js.map +1 -0
- package/dist/__tests__/strategy-router.test.d.ts +2 -0
- package/dist/__tests__/strategy-router.test.d.ts.map +1 -0
- package/dist/__tests__/strategy-router.test.js +493 -0
- package/dist/__tests__/strategy-router.test.js.map +1 -0
- package/dist/__tests__/template-engine.test.d.ts +2 -0
- package/dist/__tests__/template-engine.test.d.ts.map +1 -0
- package/dist/__tests__/template-engine.test.js +367 -0
- package/dist/__tests__/template-engine.test.js.map +1 -0
- package/dist/__tests__/validation-pipeline.test.d.ts +2 -0
- package/dist/__tests__/validation-pipeline.test.d.ts.map +1 -0
- package/dist/__tests__/validation-pipeline.test.js +262 -0
- package/dist/__tests__/validation-pipeline.test.js.map +1 -0
- package/dist/context/context-extractor.d.ts +82 -0
- package/dist/context/context-extractor.d.ts.map +1 -0
- package/dist/context/context-extractor.js +166 -0
- package/dist/context/context-extractor.js.map +1 -0
- package/dist/context/schema-formatter.d.ts +20 -0
- package/dist/context/schema-formatter.d.ts.map +1 -0
- package/dist/context/schema-formatter.js +104 -0
- package/dist/context/schema-formatter.js.map +1 -0
- package/dist/engine/nl2spel-engine.d.ts +144 -0
- package/dist/engine/nl2spel-engine.d.ts.map +1 -0
- package/dist/engine/nl2spel-engine.js +125 -0
- package/dist/engine/nl2spel-engine.js.map +1 -0
- package/dist/index.d.ts +28 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +24 -0
- package/dist/index.js.map +1 -0
- package/dist/pattern/builtin-patterns.d.ts +12 -0
- package/dist/pattern/builtin-patterns.d.ts.map +1 -0
- package/dist/pattern/builtin-patterns.js +812 -0
- package/dist/pattern/builtin-patterns.js.map +1 -0
- package/dist/pattern/pattern-definition.d.ts +49 -0
- package/dist/pattern/pattern-definition.d.ts.map +1 -0
- package/dist/pattern/pattern-definition.js +2 -0
- package/dist/pattern/pattern-definition.js.map +1 -0
- package/dist/pattern/pattern-matcher.d.ts +55 -0
- package/dist/pattern/pattern-matcher.d.ts.map +1 -0
- package/dist/pattern/pattern-matcher.js +216 -0
- package/dist/pattern/pattern-matcher.js.map +1 -0
- package/dist/provider/llm-provider.d.ts +146 -0
- package/dist/provider/llm-provider.d.ts.map +1 -0
- package/dist/provider/llm-provider.js +2 -0
- package/dist/provider/llm-provider.js.map +1 -0
- package/dist/provider/provider-registry.d.ts +28 -0
- package/dist/provider/provider-registry.d.ts.map +1 -0
- package/dist/provider/provider-registry.js +65 -0
- package/dist/provider/provider-registry.js.map +1 -0
- package/dist/strategy/strategy-router.d.ts +79 -0
- package/dist/strategy/strategy-router.d.ts.map +1 -0
- package/dist/strategy/strategy-router.js +182 -0
- package/dist/strategy/strategy-router.js.map +1 -0
- package/dist/template/intent-classifier.d.ts +56 -0
- package/dist/template/intent-classifier.d.ts.map +1 -0
- package/dist/template/intent-classifier.js +251 -0
- package/dist/template/intent-classifier.js.map +1 -0
- package/dist/template/nl-intent.d.ts +38 -0
- package/dist/template/nl-intent.d.ts.map +1 -0
- package/dist/template/nl-intent.js +39 -0
- package/dist/template/nl-intent.js.map +1 -0
- package/dist/template/prompts/prompt-builder.d.ts +20 -0
- package/dist/template/prompts/prompt-builder.d.ts.map +1 -0
- package/dist/template/prompts/prompt-builder.js +243 -0
- package/dist/template/prompts/prompt-builder.js.map +1 -0
- package/dist/template/template-engine.d.ts +27 -0
- package/dist/template/template-engine.d.ts.map +1 -0
- package/dist/template/template-engine.js +378 -0
- package/dist/template/template-engine.js.map +1 -0
- package/dist/utils/chinese-number-parser.d.ts +30 -0
- package/dist/utils/chinese-number-parser.d.ts.map +1 -0
- package/dist/utils/chinese-number-parser.js +92 -0
- package/dist/utils/chinese-number-parser.js.map +1 -0
- package/dist/validation/auto-fixer.d.ts +14 -0
- package/dist/validation/auto-fixer.d.ts.map +1 -0
- package/dist/validation/auto-fixer.js +111 -0
- package/dist/validation/auto-fixer.js.map +1 -0
- package/dist/validation/self-correction-loop.d.ts +46 -0
- package/dist/validation/self-correction-loop.d.ts.map +1 -0
- package/dist/validation/self-correction-loop.js +141 -0
- package/dist/validation/self-correction-loop.js.map +1 -0
- package/dist/validation/validation-pipeline.d.ts +81 -0
- package/dist/validation/validation-pipeline.d.ts.map +1 -0
- package/dist/validation/validation-pipeline.js +306 -0
- package/dist/validation/validation-pipeline.js.map +1 -0
- package/package.json +36 -7
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SchemaFormatter — formats ContextSchema into readable text.
|
|
3
|
+
*
|
|
4
|
+
* Two formats:
|
|
5
|
+
* 1. formatForLLM(): optimized for LLM prompts (compact, key info first)
|
|
6
|
+
* 2. formatForHuman(): human-readable format (complete, indent-friendly)
|
|
7
|
+
*/
|
|
8
|
+
export class SchemaFormatter {
|
|
9
|
+
/**
|
|
10
|
+
* LLM-optimized format — compact, injected into the User part of the prompt
|
|
11
|
+
*/
|
|
12
|
+
formatForLLM(schema) {
|
|
13
|
+
const lines = ['## Context Schema'];
|
|
14
|
+
// Root Object
|
|
15
|
+
if (schema.root) {
|
|
16
|
+
lines.push('');
|
|
17
|
+
lines.push(`Root Object (accessible as #${schema.root.name}):`);
|
|
18
|
+
lines.push(` Type: ${schema.root.type}`);
|
|
19
|
+
lines.push(` Fields:`);
|
|
20
|
+
for (const [name, field] of Object.entries(schema.root.fields)) {
|
|
21
|
+
lines.push(this.formatFieldForLLM(name, field, ' '));
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
// Variables
|
|
25
|
+
if (Object.keys(schema.variables).length > 0) {
|
|
26
|
+
lines.push('');
|
|
27
|
+
lines.push(`Variables:`);
|
|
28
|
+
for (const [name, varDef] of Object.entries(schema.variables)) {
|
|
29
|
+
lines.push(` #${name}: ${varDef.type}` + (varDef.description ? ` (${varDef.description})` : ''));
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
// Beans
|
|
33
|
+
if (Object.keys(schema.beans).length > 0) {
|
|
34
|
+
lines.push('');
|
|
35
|
+
lines.push(`Beans:`);
|
|
36
|
+
for (const [name, beanDef] of Object.entries(schema.beans)) {
|
|
37
|
+
lines.push(` @${name}: ${beanDef.type}` + (beanDef.description ? ` (${beanDef.description})` : ''));
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
// Types
|
|
41
|
+
if (Object.keys(schema.types).length > 0) {
|
|
42
|
+
lines.push('');
|
|
43
|
+
lines.push(`Types (accessible via T(typeName)):`);
|
|
44
|
+
for (const [name, typeDef] of Object.entries(schema.types)) {
|
|
45
|
+
lines.push(` ${name}` + (typeDef.description ? `: ${typeDef.description}` : ''));
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
// Functions
|
|
49
|
+
if (Object.keys(schema.functions).length > 0) {
|
|
50
|
+
lines.push('');
|
|
51
|
+
lines.push(`Functions:`);
|
|
52
|
+
for (const [name, funcDef] of Object.entries(schema.functions)) {
|
|
53
|
+
const params = funcDef.params.map(p => `${p.name}: ${p.type}`).join(', ');
|
|
54
|
+
lines.push(` #${name}(${params}): ${funcDef.returnType}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
lines.push('');
|
|
58
|
+
return lines.join('\n');
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Human-readable format
|
|
62
|
+
*/
|
|
63
|
+
formatForHuman(schema) {
|
|
64
|
+
const lines = [
|
|
65
|
+
'═══════════════════════════════════════',
|
|
66
|
+
' Context Schema (Human-Readable)',
|
|
67
|
+
'═══════════════════════════════════════',
|
|
68
|
+
];
|
|
69
|
+
if (schema.root) {
|
|
70
|
+
lines.push('');
|
|
71
|
+
lines.push(`┌─ Root: #${schema.root.name}`);
|
|
72
|
+
lines.push(`│ Type: ${schema.root.type}`);
|
|
73
|
+
lines.push(`│ Fields:`);
|
|
74
|
+
const entries = Object.entries(schema.root.fields);
|
|
75
|
+
for (let i = 0; i < entries.length; i++) {
|
|
76
|
+
const [name, field] = entries[i];
|
|
77
|
+
const prefix = i < entries.length - 1 ? '├─' : '└─';
|
|
78
|
+
lines.push(`│ ${prefix} ${name} (${field.type})` +
|
|
79
|
+
(field.description ? ` — ${field.description}` : '') +
|
|
80
|
+
(field.nullable ? ' | nullable' : '') +
|
|
81
|
+
(field.isCollection ? ` | collection<${field.elementType ?? 'unknown'}>` : ''));
|
|
82
|
+
}
|
|
83
|
+
lines.push(`│ └─ (${entries.length} fields total)`);
|
|
84
|
+
}
|
|
85
|
+
return lines.join('\n');
|
|
86
|
+
}
|
|
87
|
+
formatFieldForLLM(name, field, indent) {
|
|
88
|
+
const parts = [`${indent}- ${name}: ${field.type}`];
|
|
89
|
+
if (field.description) {
|
|
90
|
+
parts.push(`(${field.description})`);
|
|
91
|
+
}
|
|
92
|
+
if (field.isCollection) {
|
|
93
|
+
parts.push(`[array of ${field.elementType ?? 'unknown'}]`);
|
|
94
|
+
}
|
|
95
|
+
if (field.nullable) {
|
|
96
|
+
parts.push(`[nullable]`);
|
|
97
|
+
}
|
|
98
|
+
if (field.example !== undefined) {
|
|
99
|
+
parts.push(`(e.g. ${JSON.stringify(field.example)})`);
|
|
100
|
+
}
|
|
101
|
+
return parts.join(' ');
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=schema-formatter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema-formatter.js","sourceRoot":"","sources":["../../src/context/schema-formatter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { type StrategyRouterConfig } from '../strategy/strategy-router.js';
|
|
2
|
+
import type { LLMProvider } from '../provider/llm-provider.js';
|
|
3
|
+
import type { PatternDefinition } from '../pattern/pattern-definition.js';
|
|
4
|
+
import type { ContextSchema, SpelEvaluator } from '../SpelEvaluator.js';
|
|
5
|
+
export interface GenerateOptions {
|
|
6
|
+
/** Context Schema (optional) */
|
|
7
|
+
contextSchema?: ContextSchema;
|
|
8
|
+
/** Raw context object (auto-extracted to ContextSchema) */
|
|
9
|
+
context?: {
|
|
10
|
+
rootObject?: unknown;
|
|
11
|
+
rootName?: string;
|
|
12
|
+
variables?: Record<string, {
|
|
13
|
+
type: string;
|
|
14
|
+
value?: unknown;
|
|
15
|
+
description?: string;
|
|
16
|
+
nullable?: boolean;
|
|
17
|
+
}>;
|
|
18
|
+
beans?: Array<{
|
|
19
|
+
name: string;
|
|
20
|
+
type: string;
|
|
21
|
+
description?: string;
|
|
22
|
+
}>;
|
|
23
|
+
types?: Array<{
|
|
24
|
+
name: string;
|
|
25
|
+
className?: string;
|
|
26
|
+
description?: string;
|
|
27
|
+
}>;
|
|
28
|
+
};
|
|
29
|
+
/** Force using a specific LLM Provider */
|
|
30
|
+
preferredProvider?: string;
|
|
31
|
+
/** Minimum confidence threshold (default 0.5) */
|
|
32
|
+
minConfidence?: number;
|
|
33
|
+
/** Offline only (Pattern + Template, no LLM calls) */
|
|
34
|
+
offlineOnly?: boolean;
|
|
35
|
+
/** Whether validation is enabled (default true) */
|
|
36
|
+
enableValidation?: boolean;
|
|
37
|
+
/** Whether self-correction is enabled (default true) */
|
|
38
|
+
enableSelfCorrection?: boolean;
|
|
39
|
+
/** Language (default auto-detect) */
|
|
40
|
+
language?: 'zh' | 'en';
|
|
41
|
+
/** Whether to return debug information */
|
|
42
|
+
debug?: boolean;
|
|
43
|
+
}
|
|
44
|
+
export interface GenerateResult {
|
|
45
|
+
/** Generated SpEL expression */
|
|
46
|
+
expression: string;
|
|
47
|
+
/** Strategy used */
|
|
48
|
+
strategy: string;
|
|
49
|
+
/** Confidence (0-1) */
|
|
50
|
+
confidence: number;
|
|
51
|
+
/** Generation latency (ms) */
|
|
52
|
+
latencyMs: number;
|
|
53
|
+
/** Debug info (only when debug=true) */
|
|
54
|
+
debugInfo?: DebugInfo;
|
|
55
|
+
}
|
|
56
|
+
export interface DebugInfo {
|
|
57
|
+
/** Pattern match result */
|
|
58
|
+
patternMatch?: {
|
|
59
|
+
matched: boolean;
|
|
60
|
+
patternId?: string;
|
|
61
|
+
spel?: string;
|
|
62
|
+
};
|
|
63
|
+
/** Intent classification result */
|
|
64
|
+
intent?: {
|
|
65
|
+
primary: string;
|
|
66
|
+
complexity: number;
|
|
67
|
+
};
|
|
68
|
+
/** Template generation result */
|
|
69
|
+
template?: {
|
|
70
|
+
expression?: string;
|
|
71
|
+
templateName?: string;
|
|
72
|
+
};
|
|
73
|
+
/** LLM Provider info */
|
|
74
|
+
provider?: {
|
|
75
|
+
name: string;
|
|
76
|
+
model: string;
|
|
77
|
+
};
|
|
78
|
+
/** Self-correction info */
|
|
79
|
+
corrections?: {
|
|
80
|
+
attempts: number;
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
export interface ExplainResult {
|
|
84
|
+
/** Input text */
|
|
85
|
+
input: string;
|
|
86
|
+
/** Strategy used */
|
|
87
|
+
strategy: string;
|
|
88
|
+
/** Intent information */
|
|
89
|
+
intent: {
|
|
90
|
+
primary: string;
|
|
91
|
+
complexity: number;
|
|
92
|
+
all: Array<{
|
|
93
|
+
intent: string;
|
|
94
|
+
confidence: number;
|
|
95
|
+
}>;
|
|
96
|
+
};
|
|
97
|
+
/** Whether pattern was matched */
|
|
98
|
+
patternMatched: boolean;
|
|
99
|
+
/** Matched Pattern ID */
|
|
100
|
+
patternId?: string;
|
|
101
|
+
/** Final expression */
|
|
102
|
+
expression: string;
|
|
103
|
+
/** All possible expressions (from different strategies) */
|
|
104
|
+
alternatives: string[];
|
|
105
|
+
}
|
|
106
|
+
export declare class NL2SpelEngine {
|
|
107
|
+
private readonly router;
|
|
108
|
+
private readonly providerRegistry;
|
|
109
|
+
constructor(config?: StrategyRouterConfig);
|
|
110
|
+
/**
|
|
111
|
+
* Register an LLM Provider
|
|
112
|
+
*/
|
|
113
|
+
registerProvider(provider: LLMProvider): void;
|
|
114
|
+
/**
|
|
115
|
+
* Unregister an LLM Provider
|
|
116
|
+
*/
|
|
117
|
+
unregisterProvider(name: string): void;
|
|
118
|
+
/**
|
|
119
|
+
* Register a custom Pattern
|
|
120
|
+
*/
|
|
121
|
+
registerPattern(pattern: PatternDefinition): void;
|
|
122
|
+
/**
|
|
123
|
+
* Set SpelEvaluator for validation pipeline.
|
|
124
|
+
* Must be called before generate() if parse-level validation is required.
|
|
125
|
+
*/
|
|
126
|
+
setSpelEvaluator(evaluator: SpelEvaluator): void;
|
|
127
|
+
/**
|
|
128
|
+
* Extract ContextSchema from raw context object
|
|
129
|
+
*/
|
|
130
|
+
extractContextSchema(context: NonNullable<GenerateOptions['context']>): ContextSchema;
|
|
131
|
+
/**
|
|
132
|
+
* Core generation API
|
|
133
|
+
*/
|
|
134
|
+
generate(nl: string, options?: GenerateOptions): Promise<GenerateResult>;
|
|
135
|
+
/**
|
|
136
|
+
* Batch generation
|
|
137
|
+
*/
|
|
138
|
+
generateBatch(nls: string[], options?: GenerateOptions): Promise<GenerateResult[]>;
|
|
139
|
+
/**
|
|
140
|
+
* Debug explanation
|
|
141
|
+
*/
|
|
142
|
+
explain(nl: string, options?: GenerateOptions): Promise<ExplainResult>;
|
|
143
|
+
}
|
|
144
|
+
//# sourceMappingURL=nl2spel-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nl2spel-engine.d.ts","sourceRoot":"","sources":["../../src/engine/nl2spel-engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { StrategyRouter } from '../strategy/strategy-router.js';
|
|
2
|
+
import { ProviderRegistry } from '../provider/provider-registry.js';
|
|
3
|
+
import { PatternMatcher } from '../pattern/pattern-matcher.js';
|
|
4
|
+
import { IntentClassifier } from '../template/intent-classifier.js';
|
|
5
|
+
import { ContextExtractor } from '../context/context-extractor.js';
|
|
6
|
+
import { ValidationPipeline } from '../validation/validation-pipeline.js';
|
|
7
|
+
export class NL2SpelEngine {
|
|
8
|
+
router;
|
|
9
|
+
providerRegistry;
|
|
10
|
+
constructor(config = {}) {
|
|
11
|
+
this.providerRegistry = new ProviderRegistry();
|
|
12
|
+
this.router = new StrategyRouter(this.providerRegistry, config);
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Register an LLM Provider
|
|
16
|
+
*/
|
|
17
|
+
registerProvider(provider) {
|
|
18
|
+
this.providerRegistry.register(provider);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Unregister an LLM Provider
|
|
22
|
+
*/
|
|
23
|
+
unregisterProvider(name) {
|
|
24
|
+
this.providerRegistry.unregister(name);
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Register a custom Pattern
|
|
28
|
+
*/
|
|
29
|
+
registerPattern(pattern) {
|
|
30
|
+
this.router.getPatternMatcher().register(pattern);
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Set SpelEvaluator for validation pipeline.
|
|
34
|
+
* Must be called before generate() if parse-level validation is required.
|
|
35
|
+
*/
|
|
36
|
+
setSpelEvaluator(evaluator) {
|
|
37
|
+
this.router.setEvaluator(evaluator);
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Extract ContextSchema from raw context object
|
|
41
|
+
*/
|
|
42
|
+
extractContextSchema(context) {
|
|
43
|
+
const extractor = new ContextExtractor();
|
|
44
|
+
return extractor.extract(context);
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Core generation API
|
|
48
|
+
*/
|
|
49
|
+
async generate(nl, options = {}) {
|
|
50
|
+
const startTime = Date.now();
|
|
51
|
+
// Build ContextSchema
|
|
52
|
+
let contextSchema = options.contextSchema;
|
|
53
|
+
if (!contextSchema && options.context) {
|
|
54
|
+
const extractor = new ContextExtractor();
|
|
55
|
+
contextSchema = extractor.extract(options.context);
|
|
56
|
+
}
|
|
57
|
+
// Offline mode
|
|
58
|
+
if (options.offlineOnly) {
|
|
59
|
+
const patternMatcher = this.router.getPatternMatcher();
|
|
60
|
+
const patternResult = patternMatcher.match(nl);
|
|
61
|
+
if (patternResult.matched) {
|
|
62
|
+
return {
|
|
63
|
+
expression: patternResult.spel,
|
|
64
|
+
strategy: 'pattern',
|
|
65
|
+
confidence: patternResult.confidence,
|
|
66
|
+
latencyMs: Date.now() - startTime,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
const classifier = new IntentClassifier();
|
|
70
|
+
const intentResult = classifier.classify(nl);
|
|
71
|
+
const templateEngine = this.router.getTemplateEngine();
|
|
72
|
+
if (contextSchema)
|
|
73
|
+
templateEngine.setContext(contextSchema);
|
|
74
|
+
const templateResult = templateEngine.generate(nl, intentResult);
|
|
75
|
+
if (templateResult) {
|
|
76
|
+
return {
|
|
77
|
+
expression: templateResult.expression,
|
|
78
|
+
strategy: 'template',
|
|
79
|
+
confidence: templateResult.confidence,
|
|
80
|
+
latencyMs: Date.now() - startTime,
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
throw new Error('Cannot generate expression offline: no pattern or template matched.');
|
|
84
|
+
}
|
|
85
|
+
// Route generation
|
|
86
|
+
const result = await this.router.generate(nl, contextSchema, options.preferredProvider);
|
|
87
|
+
return {
|
|
88
|
+
expression: result.expression,
|
|
89
|
+
strategy: result.strategy,
|
|
90
|
+
confidence: result.confidence,
|
|
91
|
+
latencyMs: Date.now() - startTime,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Batch generation
|
|
96
|
+
*/
|
|
97
|
+
async generateBatch(nls, options = {}) {
|
|
98
|
+
return Promise.all(nls.map(nl => this.generate(nl, options)));
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Debug explanation
|
|
102
|
+
*/
|
|
103
|
+
async explain(nl, options = {}) {
|
|
104
|
+
const classifier = new IntentClassifier();
|
|
105
|
+
const intentResult = classifier.classify(nl);
|
|
106
|
+
const patternMatcher = this.router.getPatternMatcher();
|
|
107
|
+
const patternResult = patternMatcher.match(nl);
|
|
108
|
+
const allPatternResults = patternMatcher.matchAll(nl, 5);
|
|
109
|
+
const result = await this.generate(nl, { ...options });
|
|
110
|
+
return {
|
|
111
|
+
input: nl,
|
|
112
|
+
strategy: result.strategy,
|
|
113
|
+
intent: {
|
|
114
|
+
primary: intentResult.primaryIntent,
|
|
115
|
+
complexity: intentResult.complexity,
|
|
116
|
+
all: intentResult.intents,
|
|
117
|
+
},
|
|
118
|
+
patternMatched: patternResult.matched,
|
|
119
|
+
patternId: patternResult.pattern?.id,
|
|
120
|
+
expression: result.expression,
|
|
121
|
+
alternatives: allPatternResults.filter(r => r.spel).map(r => r.spel),
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=nl2spel-engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nl2spel-engine.js","sourceRoot":"","sources":["../../src/engine/nl2spel-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA6B,MAAM,gCAAgC,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAqG1E,MAAM,OAAO,aAAa;IACP,MAAM,CAAiB;IACvB,gBAAgB,CAAmB;IAEpD,YAAY,SAA+B,EAAE;QAC3C,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,QAAqB;QAC3C,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,IAAY;QACpC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,OAA0B;QAC/C,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACI,gBAAgB,CAAC,SAAwB;QAC9C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,OAAgD;QAC1E,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,UAA2B,EAAE;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,sBAAsB;QACtB,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACzC,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACvD,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAE/C,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,OAAO;oBACL,UAAU,EAAE,aAAa,CAAC,IAAK;oBAC/B,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,aAAa,CAAC,UAAU;oBACpC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBAClC,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACvD,IAAI,aAAa;gBAAE,cAAc,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAC5D,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YAEjE,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO;oBACL,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,QAAQ,EAAE,UAAU;oBACpB,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBAClC,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAExF,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CACxB,GAAa,EACb,UAA2B,EAAE;QAE7B,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,UAA2B,EAAE;QAC5D,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACvD,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAEvD,OAAO;YACL,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE;gBACN,OAAO,EAAE,YAAY,CAAC,aAAa;gBACnC,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,GAAG,EAAE,YAAY,CAAC,OAAO;aAC1B;YACD,cAAc,EAAE,aAAa,CAAC,OAAO;YACrC,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,EAAE;YACpC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC;SACtE,CAAC;IACJ,CAAC;CACF"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export type { SpelEvaluator, ParseResult, ParseError, ContextSchema, RootObjectSchema, FieldSchema, VariableSchema, BeanSchema, TypeSchema, MethodSchema, FunctionSchema, } from './SpelEvaluator.js';
|
|
2
|
+
export type { LLMProvider, LLMCapabilities, LLMPrompt, LLMGenerateOptions, LLMResponse, LLMStreamChunk, LLMUsage, FewShotExample, } from './provider/llm-provider.js';
|
|
3
|
+
export { ProviderRegistry } from './provider/provider-registry.js';
|
|
4
|
+
export { ContextExtractor } from './context/context-extractor.js';
|
|
5
|
+
export { SchemaFormatter } from './context/schema-formatter.js';
|
|
6
|
+
export type { PatternDefinition, SlotDefinition, SlotTransform, } from './pattern/pattern-definition.js';
|
|
7
|
+
export { PatternMatcher } from './pattern/pattern-matcher.js';
|
|
8
|
+
export type { PatternMatchResult } from './pattern/pattern-matcher.js';
|
|
9
|
+
export { BUILTIN_PATTERNS } from './pattern/builtin-patterns.js';
|
|
10
|
+
export { NLIntent } from './template/nl-intent.js';
|
|
11
|
+
export { IntentClassifier } from './template/intent-classifier.js';
|
|
12
|
+
export type { IntentResult, IntentEntity } from './template/intent-classifier.js';
|
|
13
|
+
export { TemplateEngine } from './template/template-engine.js';
|
|
14
|
+
export type { TemplateResult } from './template/template-engine.js';
|
|
15
|
+
export { PromptBuilder } from './template/prompts/prompt-builder.js';
|
|
16
|
+
export type { PromptBuilderOptions } from './template/prompts/prompt-builder.js';
|
|
17
|
+
export { ValidationPipeline } from './validation/validation-pipeline.js';
|
|
18
|
+
export type { ValidationResult, ValidationError, ValidationWarning, StageResult, } from './validation/validation-pipeline.js';
|
|
19
|
+
export { AutoFixer } from './validation/auto-fixer.js';
|
|
20
|
+
export type { AutoFixResult } from './validation/auto-fixer.js';
|
|
21
|
+
export { SelfCorrectionLoop } from './validation/self-correction-loop.js';
|
|
22
|
+
export type { SelfCorrectionResult, CorrectionLog, SelfCorrectionConfig, } from './validation/self-correction-loop.js';
|
|
23
|
+
export { StrategyRouter } from './strategy/strategy-router.js';
|
|
24
|
+
export type { StrategyType, StrategyResult, StrategyMetadata, StrategyRouterConfig, } from './strategy/strategy-router.js';
|
|
25
|
+
export { NL2SpelEngine } from './engine/nl2spel-engine.js';
|
|
26
|
+
export type { GenerateOptions, GenerateResult, ExplainResult, DebugInfo, } from './engine/nl2spel-engine.js';
|
|
27
|
+
export { ChineseNumberParser } from './utils/chinese-number-parser.js';
|
|
28
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,WAAW,EACX,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,GACf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,SAAS,GACV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// Core public API — @agentix-e/nl2spel
|
|
2
|
+
// ProviderRegistry
|
|
3
|
+
export { ProviderRegistry } from './provider/provider-registry.js';
|
|
4
|
+
// Context
|
|
5
|
+
export { ContextExtractor } from './context/context-extractor.js';
|
|
6
|
+
export { SchemaFormatter } from './context/schema-formatter.js';
|
|
7
|
+
export { PatternMatcher } from './pattern/pattern-matcher.js';
|
|
8
|
+
export { BUILTIN_PATTERNS } from './pattern/builtin-patterns.js';
|
|
9
|
+
// Template (Layer 1)
|
|
10
|
+
export { NLIntent } from './template/nl-intent.js';
|
|
11
|
+
export { IntentClassifier } from './template/intent-classifier.js';
|
|
12
|
+
export { TemplateEngine } from './template/template-engine.js';
|
|
13
|
+
export { PromptBuilder } from './template/prompts/prompt-builder.js';
|
|
14
|
+
// Validation (Layer 2)
|
|
15
|
+
export { ValidationPipeline } from './validation/validation-pipeline.js';
|
|
16
|
+
export { AutoFixer } from './validation/auto-fixer.js';
|
|
17
|
+
export { SelfCorrectionLoop } from './validation/self-correction-loop.js';
|
|
18
|
+
// Strategy Router (Layer 2)
|
|
19
|
+
export { StrategyRouter } from './strategy/strategy-router.js';
|
|
20
|
+
// NL2Spel Engine
|
|
21
|
+
export { NL2SpelEngine } from './engine/nl2spel-engine.js';
|
|
22
|
+
// Utils
|
|
23
|
+
export { ChineseNumberParser } from './utils/chinese-number-parser.js';
|
|
24
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AA6BvC,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQhE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGrE,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAOzE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAO1E,4BAA4B;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAQ/D,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ3D,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { PatternDefinition } from './pattern-definition.js';
|
|
2
|
+
/**
|
|
3
|
+
* Built-in pattern library — covers ≥80% Easy scenarios, ≥35 PatternDefinitions.
|
|
4
|
+
*
|
|
5
|
+
* Core design:
|
|
6
|
+
* 1. All patterns use named capture groups `(?<field>…)` or `(?<value>…)` to extract parameters
|
|
7
|
+
* 2. Separate Chinese/English patterns (don't mix keywords, avoids cross-language false matches)
|
|
8
|
+
* 3. High-specificity patterns have higher priority ("not empty" > "not")
|
|
9
|
+
* 4. Sorted by priority descending
|
|
10
|
+
*/
|
|
11
|
+
export declare const BUILTIN_PATTERNS: PatternDefinition[];
|
|
12
|
+
//# sourceMappingURL=builtin-patterns.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builtin-patterns.d.ts","sourceRoot":"","sources":["../../src/pattern/builtin-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EA20B/C,CAAC"}
|