speckl/compiler/dist/parser.d.ts
Scott Scoble f19a43fd5f Add SpeckDL compiler scaffold
- CLI entry point with yargs parsing for speckl-compile <file> --output-dir --bom-format
- TypeScript parser with AST types for all SpeckDL primitives
- Generator for PROV-O JSON-LD provenance graphs
- Generator for CycloneDX v1.6 BOMs
- Generator for SPDX 3.0.1 BOMs
- E2E test verifying RetryHandler.speck parsing and all output formats

All tests pass.
2026-04-29 15:12:08 -07:00

121 lines
No EOL
2.7 KiB
TypeScript

export interface SpeckNode {
type: 'speck';
name: string;
members: MemberNode[];
}
export interface ImportNode {
type: 'import';
path: string;
alias?: string;
version?: string;
hash?: string;
}
export interface InputNode {
type: 'input';
typeExpr: TypeExpr;
}
export interface OutputNode {
type: 'output';
typeExpr: TypeExpr;
}
export interface ConstraintNode {
type: 'constraint';
expr: string;
}
export interface VerifyNode {
type: 'verify';
temporalExpr: string;
}
export interface InterfaceNode {
type: 'interface';
name: string;
methods: MethodSignature[];
}
export interface MethodSignature {
name: string;
params: {
name: string;
type: TypeExpr;
}[];
returnType: TypeExpr;
}
export interface EventNode {
type: 'event';
name: string;
fields: {
name: string;
type: TypeExpr;
}[];
}
export interface ProvenanceNode {
type: 'provenance';
clauses: ProvenanceClause[];
}
export interface ProvenanceClause {
type: 'regulation' | 'design_decision' | 'parent_spec' | 'external_doc';
value: string;
location?: string;
}
export interface ReviewNode {
type: 'review';
kind: 'manual' | 'auto' | 'hybrid';
}
export interface DerivesNode {
type: 'derives';
from: string;
via?: string;
}
export interface SatisfiesNode {
type: 'satisfies';
requirement: string;
clause?: string;
}
export interface AuthorNode {
type: 'author';
name: string;
email?: string;
}
export interface SourceNode {
type: 'source';
kind: 'conversation' | 'meeting' | 'document' | 'regulation' | 'architecture_review' | 'threat_model' | 'compliance_audit';
ref?: string;
}
export interface BOMNode {
type: 'bom';
compiler?: {
name: string;
version?: string;
};
solver?: {
name: string;
version?: string;
};
runtime?: {
name: string;
version?: string;
};
license?: string;
hash?: string;
}
export type MemberNode = ImportNode | InputNode | OutputNode | ConstraintNode | VerifyNode | InterfaceNode | EventNode | ProvenanceNode | ReviewNode | DerivesNode | SatisfiesNode | AuthorNode | SourceNode | BOMNode;
export interface TypeExpr {
type: 'primitive' | 'record' | 'list' | 'ident';
name?: string;
fields?: {
name: string;
type: TypeExpr;
}[];
elementType?: TypeExpr;
}
export interface AST {
specks: SpeckNode[];
}
/**
* Parse a .speck file and return the AST
*/
export declare function parseSpeckFile(filePath: string): AST;
/**
* Parse SpeckDL content and return the AST
*/
export declare function parseSpeckContent(content: string, filePath?: string): AST;
//# sourceMappingURL=parser.d.ts.map