@m4ike1/ion-cue 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+import type { CueMessage } from "./messages.ts";
+export type BehavioralDimension = "tone" | "register" | "length" | "depth" | "structure" | "format" | "voice" | "vocabulary";
+export interface TagDef {
+    description: string;
+    overrides: BehavioralDimension[];
+    exclusive?: boolean;
+    inline?: string;
+}
+export interface UsesEntry {
+    tag: string;
+    source: string;
+}
+export interface ElementDef {
+    name: string;
+    description: string;
+    version: string;
+    class: "model" | "harness";
+    handler?: string;
+    allowedTools?: string;
+    inputs?: string[];
+    tags: Record<string, TagDef>;
+    uses: UsesEntry[];
+    bodyPath?: string;
+    tomlPath?: string;
+}
+export interface SectionRange {
+    start: number;
+    end: number;
+    tag: string;
+}
+export type ScopeKind = "file" | "glob" | "id" | "skill";
+export interface CueScope {
+    type: ScopeKind;
+    value: string;
+    /** Line range (1-indexed, inclusive). Missing bound means open-ended (`:10-`, `:-20`). */
+    range?: {
+        start?: number;
+        end?: number;
+    };
+}
+export interface CueDirective {
+    raw: string;
+    element: string;
+    version?: string;
+    tags: string[];
+    /** Cues are purely behavioral — never populated by the scanner. Kept for type stability. */
+    scope: CueScope | null;
+    line: number;
+    col: number;
+    /** Character offset in the input message, for injection ordering. */
+    position?: number;
+}
+export interface SystemNavCommand {
+    command: string;
+    arg?: string;
+}
+export interface AliasCommand {
+    command: string;
+}
+export interface ScopeOnlyStatement {
+    scope: CueScope;
+    /** Character offset of `{` in the input message. */
+    position: number;
+    raw: string;
+}
+export type Directive = {
+    kind: "cue";
+    directive: CueDirective;
+} | {
+    kind: "system-nav";
+    command: SystemNavCommand;
+} | {
+    kind: "alias";
+    command: AliasCommand;
+} | {
+    kind: "scope-only";
+    statement: ScopeOnlyStatement;
+};
+export interface Injection {
+    text: string;
+    scope: CueScope | null;
+}
+export interface ScanError {
+    message: string;
+    raw: string;
+    line: number;
+    col: number;
+}
+export interface HarnessAction {
+    element: string;
+    handler: string;
+    args: Record<string, unknown>;
+}
+export interface DispatchResult {
+    injections: Injection[];
+    harnessActions: HarnessAction[];
+    error?: string;
+}
+export interface HookInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    hook_event_name: string;
+    prompt: string;
+}
+export interface HookOutput {
+    hookSpecificOutput?: {
+        hookEventName: string;
+        additionalContext?: string;
+    };
+    decision?: "block";
+    reason?: string;
+}
+export type HarnessHandler = (ctx: HarnessContext) => HarnessResult | Promise<HarnessResult>;
+export interface HarnessContext {
+    element: ElementDef;
+    directive: CueDirective;
+    session: SessionState;
+    args: Record<string, unknown>;
+}
+export interface HarnessResult {
+    action: "handled" | "error";
+    data?: unknown;
+    error?: string;
+}
+export interface SessionState {
+    mode: string;
+    activeElements: Map<string, ActiveElement>;
+    overrides: Map<string, string>;
+    dispatchHistory: DispatchEntry[];
+}
+export interface ActiveElement {
+    element: ElementDef;
+    tags: string[];
+    scope: CueScope | null;
+    activatedAt: number;
+}
+export interface DispatchEntry {
+    directive: CueDirective;
+    element: ElementDef;
+    tags: string[];
+    scope: CueScope | null;
+    timestamp: number;
+}
+export interface CueBeforeToolCallContext {
+    name: string;
+    args: Record<string, unknown>;
+    sessionId: string;
+}
+export interface CueBeforeToolCallResult {
+    block?: boolean;
+    reason?: string;
+}
+export interface CueAfterToolCallContext {
+    name: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    sessionId: string;
+}
+export interface CueRegisteredTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown>;
+    executionMode?: "parallel" | "sequential";
+    beforeToolCall?: (ctx: CueBeforeToolCallContext) => Promise<CueBeforeToolCallResult> | CueBeforeToolCallResult;
+    afterToolCall?: (ctx: CueAfterToolCallContext) => Promise<unknown> | undefined;
+}
+export interface CueToolSchema {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export interface CueAgentConfig {
+    streamFn: (messages: CueMessage[], tools?: CueToolSchema[], signal?: AbortSignal) => AsyncIterable<import("./stream-events.ts").CueStreamEvent>;
+    tools: CueRegisteredTool[];
+    dispatcher: any;
+    persist?: string;
+    theme?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CueMessage } from \"./messages.ts\";\n\nexport type BehavioralDimension =\n\t| \"tone\"\n\t| \"register\"\n\t| \"length\"\n\t| \"depth\"\n\t| \"structure\"\n\t| \"format\"\n\t| \"voice\"\n\t| \"vocabulary\";\n\nexport interface TagDef {\n\tdescription: string;\n\toverrides: BehavioralDimension[];\n\texclusive?: boolean;\n\tinline?: string;\n}\n\nexport interface UsesEntry {\n\ttag: string;\n\tsource: string;\n}\n\nexport interface ElementDef {\n\tname: string;\n\tdescription: string;\n\tversion: string;\n\tclass: \"model\" | \"harness\";\n\thandler?: string;\n\tallowedTools?: string;\n\tinputs?: string[];\n\ttags: Record<string, TagDef>;\n\tuses: UsesEntry[];\n\tbodyPath?: string;\n\ttomlPath?: string;\n}\n\nexport interface SectionRange {\n\tstart: number;\n\tend: number;\n\ttag: string;\n}\n\nexport type ScopeKind = \"file\" | \"glob\" | \"id\" | \"skill\";\n\nexport interface CueScope {\n\ttype: ScopeKind;\n\tvalue: string;\n\t/** Line range (1-indexed, inclusive). Missing bound means open-ended (`:10-`, `:-20`). */\n\trange?: { start?: number; end?: number };\n}\n\nexport interface CueDirective {\n\traw: string;\n\telement: string;\n\tversion?: string;\n\ttags: string[];\n\t/** Cues are purely behavioral — never populated by the scanner. Kept for type stability. */\n\tscope: CueScope | null;\n\tline: number;\n\tcol: number;\n\t/** Character offset in the input message, for injection ordering. */\n\tposition?: number;\n}\n\nexport interface SystemNavCommand {\n\tcommand: string;\n\targ?: string;\n}\n\nexport interface AliasCommand {\n\tcommand: string;\n}\n\nexport interface ScopeOnlyStatement {\n\tscope: CueScope;\n\t/** Character offset of `{` in the input message. */\n\tposition: number;\n\traw: string;\n}\n\nexport type Directive =\n\t| { kind: \"cue\"; directive: CueDirective }\n\t| { kind: \"system-nav\"; command: SystemNavCommand }\n\t| { kind: \"alias\"; command: AliasCommand }\n\t| { kind: \"scope-only\"; statement: ScopeOnlyStatement };\n\nexport interface Injection {\n\ttext: string;\n\tscope: CueScope | null;\n}\n\nexport interface ScanError {\n\tmessage: string;\n\traw: string;\n\tline: number;\n\tcol: number;\n}\n\nexport interface HarnessAction {\n\telement: string;\n\thandler: string;\n\targs: Record<string, unknown>;\n}\n\nexport interface DispatchResult {\n\tinjections: Injection[];\n\tharnessActions: HarnessAction[];\n\terror?: string;\n}\n\nexport interface HookInput {\n\tsession_id: string;\n\ttranscript_path: string;\n\tcwd: string;\n\tpermission_mode: string;\n\thook_event_name: string;\n\tprompt: string;\n}\n\nexport interface HookOutput {\n\thookSpecificOutput?: {\n\t\thookEventName: string;\n\t\tadditionalContext?: string;\n\t};\n\tdecision?: \"block\";\n\treason?: string;\n}\n\nexport type HarnessHandler = (ctx: HarnessContext) => HarnessResult | Promise<HarnessResult>;\n\nexport interface HarnessContext {\n\telement: ElementDef;\n\tdirective: CueDirective;\n\tsession: SessionState;\n\targs: Record<string, unknown>;\n}\n\nexport interface HarnessResult {\n\taction: \"handled\" | \"error\";\n\tdata?: unknown;\n\terror?: string;\n}\n\nexport interface SessionState {\n\tmode: string;\n\tactiveElements: Map<string, ActiveElement>;\n\toverrides: Map<string, string>;\n\tdispatchHistory: DispatchEntry[];\n}\n\nexport interface ActiveElement {\n\telement: ElementDef;\n\ttags: string[];\n\tscope: CueScope | null;\n\tactivatedAt: number;\n}\n\nexport interface DispatchEntry {\n\tdirective: CueDirective;\n\telement: ElementDef;\n\ttags: string[];\n\tscope: CueScope | null;\n\ttimestamp: number;\n}\n\nexport interface CueBeforeToolCallContext {\n\tname: string;\n\targs: Record<string, unknown>;\n\tsessionId: string;\n}\n\nexport interface CueBeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\nexport interface CueAfterToolCallContext {\n\tname: string;\n\targs: Record<string, unknown>;\n\tresult: unknown;\n\tsessionId: string;\n}\n\nexport interface CueRegisteredTool {\n\tname: string;\n\tdescription: string;\n\tinputSchema: Record<string, unknown>;\n\texecute: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown>;\n\texecutionMode?: \"parallel\" | \"sequential\";\n\tbeforeToolCall?: (ctx: CueBeforeToolCallContext) => Promise<CueBeforeToolCallResult> | CueBeforeToolCallResult;\n\tafterToolCall?: (ctx: CueAfterToolCallContext) => Promise<unknown> | undefined;\n}\n\nexport interface CueToolSchema {\n\tname: string;\n\tdescription: string;\n\tinput_schema: Record<string, unknown>;\n}\n\nexport interface CueAgentConfig {\n\tstreamFn: (\n\t\tmessages: CueMessage[],\n\t\ttools?: CueToolSchema[],\n\t\tsignal?: AbortSignal,\n\t) => AsyncIterable<import(\"./stream-events.ts\").CueStreamEvent>;\n\ttools: CueRegisteredTool[];\n\tdispatcher: any;\n\tpersist?: string;\n\ttheme?: string;\n}\n"]}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { CueMessage } from \"./messages.ts\";\n\nexport type BehavioralDimension =\n\t| \"tone\"\n\t| \"register\"\n\t| \"length\"\n\t| \"depth\"\n\t| \"structure\"\n\t| \"format\"\n\t| \"voice\"\n\t| \"vocabulary\";\n\nexport interface TagDef {\n\tdescription: string;\n\toverrides: BehavioralDimension[];\n\texclusive?: boolean;\n\tinline?: string;\n}\n\nexport interface UsesEntry {\n\ttag: string;\n\tsource: string;\n}\n\nexport interface ElementDef {\n\tname: string;\n\tdescription: string;\n\tversion: string;\n\tclass: \"model\" | \"harness\";\n\thandler?: string;\n\tallowedTools?: string;\n\tinputs?: string[];\n\ttags: Record<string, TagDef>;\n\tuses: UsesEntry[];\n\tbodyPath?: string;\n\ttomlPath?: string;\n}\n\nexport interface SectionRange {\n\tstart: number;\n\tend: number;\n\ttag: string;\n}\n\nexport type ScopeKind = \"file\" | \"glob\" | \"id\" | \"skill\";\n\nexport interface CueScope {\n\ttype: ScopeKind;\n\tvalue: string;\n\t/** Line range (1-indexed, inclusive). Missing bound means open-ended (`:10-`, `:-20`). */\n\trange?: { start?: number; end?: number };\n}\n\nexport interface CueDirective {\n\traw: string;\n\telement: string;\n\tversion?: string;\n\ttags: string[];\n\t/** Cues are purely behavioral — never populated by the scanner. Kept for type stability. */\n\tscope: CueScope | null;\n\tline: number;\n\tcol: number;\n\t/** Character offset in the input message, for injection ordering. */\n\tposition?: number;\n}\n\nexport interface SystemNavCommand {\n\tcommand: string;\n\targ?: string;\n}\n\nexport interface AliasCommand {\n\tcommand: string;\n}\n\nexport interface ScopeOnlyStatement {\n\tscope: CueScope;\n\t/** Character offset of `{` in the input message. */\n\tposition: number;\n\traw: string;\n}\n\nexport type Directive =\n\t| { kind: \"cue\"; directive: CueDirective }\n\t| { kind: \"system-nav\"; command: SystemNavCommand }\n\t| { kind: \"alias\"; command: AliasCommand }\n\t| { kind: \"scope-only\"; statement: ScopeOnlyStatement };\n\nexport interface Injection {\n\ttext: string;\n\tscope: CueScope | null;\n}\n\nexport interface ScanError {\n\tmessage: string;\n\traw: string;\n\tline: number;\n\tcol: number;\n}\n\nexport interface HarnessAction {\n\telement: string;\n\thandler: string;\n\targs: Record<string, unknown>;\n}\n\nexport interface DispatchResult {\n\tinjections: Injection[];\n\tharnessActions: HarnessAction[];\n\terror?: string;\n}\n\nexport interface HookInput {\n\tsession_id: string;\n\ttranscript_path: string;\n\tcwd: string;\n\tpermission_mode: string;\n\thook_event_name: string;\n\tprompt: string;\n}\n\nexport interface HookOutput {\n\thookSpecificOutput?: {\n\t\thookEventName: string;\n\t\tadditionalContext?: string;\n\t};\n\tdecision?: \"block\";\n\treason?: string;\n}\n\nexport type HarnessHandler = (ctx: HarnessContext) => HarnessResult | Promise<HarnessResult>;\n\nexport interface HarnessContext {\n\telement: ElementDef;\n\tdirective: CueDirective;\n\tsession: SessionState;\n\targs: Record<string, unknown>;\n}\n\nexport interface HarnessResult {\n\taction: \"handled\" | \"error\";\n\tdata?: unknown;\n\terror?: string;\n}\n\nexport interface SessionState {\n\tmode: string;\n\tactiveElements: Map<string, ActiveElement>;\n\toverrides: Map<string, string>;\n\tdispatchHistory: DispatchEntry[];\n}\n\nexport interface ActiveElement {\n\telement: ElementDef;\n\ttags: string[];\n\tscope: CueScope | null;\n\tactivatedAt: number;\n}\n\nexport interface DispatchEntry {\n\tdirective: CueDirective;\n\telement: ElementDef;\n\ttags: string[];\n\tscope: CueScope | null;\n\ttimestamp: number;\n}\n\nexport interface CueBeforeToolCallContext {\n\tname: string;\n\targs: Record<string, unknown>;\n\tsessionId: string;\n}\n\nexport interface CueBeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\nexport interface CueAfterToolCallContext {\n\tname: string;\n\targs: Record<string, unknown>;\n\tresult: unknown;\n\tsessionId: string;\n}\n\nexport interface CueRegisteredTool {\n\tname: string;\n\tdescription: string;\n\tinputSchema: Record<string, unknown>;\n\texecute: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown>;\n\texecutionMode?: \"parallel\" | \"sequential\";\n\tbeforeToolCall?: (ctx: CueBeforeToolCallContext) => Promise<CueBeforeToolCallResult> | CueBeforeToolCallResult;\n\tafterToolCall?: (ctx: CueAfterToolCallContext) => Promise<unknown> | undefined;\n}\n\nexport interface CueToolSchema {\n\tname: string;\n\tdescription: string;\n\tinput_schema: Record<string, unknown>;\n}\n\nexport interface CueAgentConfig {\n\tstreamFn: (\n\t\tmessages: CueMessage[],\n\t\ttools?: CueToolSchema[],\n\t\tsignal?: AbortSignal,\n\t) => AsyncIterable<import(\"./stream-events.ts\").CueStreamEvent>;\n\ttools: CueRegisteredTool[];\n\tdispatcher: any;\n\tpersist?: string;\n\ttheme?: string;\n}\n"]}

package/dist/validation.d.ts

@@ -0,0 +1,5 @@
+import type { CueDirective, ElementDef } from "./types.ts";
+export declare function validateVersionPin(version: string): string | null;
+export declare function detectCircularUses(elements: Map<string, ElementDef>): string[];
+export declare function detectConflictingReplace(directives: CueDirective[]): string[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAsC9E;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAgB7E","sourcesContent":["import type { CueDirective, ElementDef } from \"./types.ts\";\n\nexport function validateVersionPin(version: string): string | null {\n\tif (!version) return null;\n\tconst semverRe = /^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$/;\n\tif (!semverRe.test(version)) {\n\t\treturn `Malformed version pin: '${version}' is not a valid semver range`;\n\t}\n\treturn null;\n}\n\nexport function detectCircularUses(elements: Map<string, ElementDef>): string[] {\n\tconst errors: string[] = [];\n\tconst cycles = new Set<string>();\n\tconst visited = new Set<string>();\n\n\tfunction dfs(name: string, path: string[], stack: Set<string>) {\n\t\tif (stack.has(name)) {\n\t\t\tconst cycleStart = path.indexOf(name);\n\t\t\tconst cycleNodes = [...path.slice(cycleStart), name].sort();\n\t\t\tconst cycleKey = cycleNodes.join(\"→\");\n\t\t\tif (!cycles.has(cycleKey)) {\n\t\t\t\tcycles.add(cycleKey);\n\t\t\t\terrors.push(`Circular [[uses]] detected: ${path.slice(cycleStart).join(\" → \")} → ${name}`);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (visited.has(name)) return;\n\n\t\tvisited.add(name);\n\t\tstack.add(name);\n\n\t\tconst el = elements.get(name);\n\t\tif (el) {\n\t\t\tfor (const use of el.uses) {\n\t\t\t\tdfs(use.tag, [...path, name], stack);\n\t\t\t}\n\t\t}\n\n\t\tstack.delete(name);\n\t}\n\n\tfor (const [name] of elements) {\n\t\tif (!name.includes(\"/\")) {\n\t\t\tdfs(name, [], new Set());\n\t\t}\n\t}\n\n\treturn errors;\n}\n\nexport function detectConflictingReplace(directives: CueDirective[]): string[] {\n\tconst errors: string[] = [];\n\tconst scopeTargets = new Map<string, CueDirective[]>();\n\n\tfor (const d of directives) {\n\t\tif (!d.scope) continue;\n\t\tconst key = d.scope.value;\n\t\tconst existing = scopeTargets.get(key);\n\t\tif (existing) {\n\t\t\texisting.push(d);\n\t\t} else {\n\t\t\tscopeTargets.set(key, [d]);\n\t\t}\n\t}\n\n\treturn errors;\n}\n"]}

package/dist/validation.js

@@ -0,0 +1,61 @@
+export function validateVersionPin(version) {
+    if (!version)
+        return null;
+    const semverRe = /^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?(\+[a-zA-Z0-9.]+)?$/;
+    if (!semverRe.test(version)) {
+        return `Malformed version pin: '${version}' is not a valid semver range`;
+    }
+    return null;
+}
+export function detectCircularUses(elements) {
+    const errors = [];
+    const cycles = new Set();
+    const visited = new Set();
+    function dfs(name, path, stack) {
+        if (stack.has(name)) {
+            const cycleStart = path.indexOf(name);
+            const cycleNodes = [...path.slice(cycleStart), name].sort();
+            const cycleKey = cycleNodes.join("→");
+            if (!cycles.has(cycleKey)) {
+                cycles.add(cycleKey);
+                errors.push(`Circular [[uses]] detected: ${path.slice(cycleStart).join(" → ")} → ${name}`);
+            }
+            return;
+        }
+        if (visited.has(name))
+            return;
+        visited.add(name);
+        stack.add(name);
+        const el = elements.get(name);
+        if (el) {
+            for (const use of el.uses) {
+                dfs(use.tag, [...path, name], stack);
+            }
+        }
+        stack.delete(name);
+    }
+    for (const [name] of elements) {
+        if (!name.includes("/")) {
+            dfs(name, [], new Set());
+        }
+    }
+    return errors;
+}
+export function detectConflictingReplace(directives) {
+    const errors = [];
+    const scopeTargets = new Map();
+    for (const d of directives) {
+        if (!d.scope)
+            continue;
+        const key = d.scope.value;
+        const existing = scopeTargets.get(key);
+        if (existing) {
+            existing.push(d);
+        }
+        else {
+            scopeTargets.set(key, [d]);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAiB;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,QAAQ,GAAG,oDAAoD,CAAC;IACtE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,2BAA2B,OAAO,+BAA+B,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAiC,EAAY;IAC/E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,SAAS,GAAG,CAAC,IAAY,EAAE,IAAc,EAAE,KAAkB,EAAE;QAC9D,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,KAAG,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAK,CAAC,QAAM,IAAI,EAAE,CAAC,CAAC;YAC5F,CAAC;YACD,OAAO;QACR,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAE9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,EAAE,CAAC;YACR,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YACtC,CAAC;QACF,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAAA,CACnB;IAED,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AAAA,CACd;AAED,MAAM,UAAU,wBAAwB,CAAC,UAA0B,EAAY;IAC9E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEvD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,KAAK;YAAE,SAAS;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACP,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AAAA,CACd","sourcesContent":["import type { CueDirective, ElementDef } from \"./types.ts\";\n\nexport function validateVersionPin(version: string): string | null {\n\tif (!version) return null;\n\tconst semverRe = /^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$/;\n\tif (!semverRe.test(version)) {\n\t\treturn `Malformed version pin: '${version}' is not a valid semver range`;\n\t}\n\treturn null;\n}\n\nexport function detectCircularUses(elements: Map<string, ElementDef>): string[] {\n\tconst errors: string[] = [];\n\tconst cycles = new Set<string>();\n\tconst visited = new Set<string>();\n\n\tfunction dfs(name: string, path: string[], stack: Set<string>) {\n\t\tif (stack.has(name)) {\n\t\t\tconst cycleStart = path.indexOf(name);\n\t\t\tconst cycleNodes = [...path.slice(cycleStart), name].sort();\n\t\t\tconst cycleKey = cycleNodes.join(\"→\");\n\t\t\tif (!cycles.has(cycleKey)) {\n\t\t\t\tcycles.add(cycleKey);\n\t\t\t\terrors.push(`Circular [[uses]] detected: ${path.slice(cycleStart).join(\" → \")} → ${name}`);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (visited.has(name)) return;\n\n\t\tvisited.add(name);\n\t\tstack.add(name);\n\n\t\tconst el = elements.get(name);\n\t\tif (el) {\n\t\t\tfor (const use of el.uses) {\n\t\t\t\tdfs(use.tag, [...path, name], stack);\n\t\t\t}\n\t\t}\n\n\t\tstack.delete(name);\n\t}\n\n\tfor (const [name] of elements) {\n\t\tif (!name.includes(\"/\")) {\n\t\t\tdfs(name, [], new Set());\n\t\t}\n\t}\n\n\treturn errors;\n}\n\nexport function detectConflictingReplace(directives: CueDirective[]): string[] {\n\tconst errors: string[] = [];\n\tconst scopeTargets = new Map<string, CueDirective[]>();\n\n\tfor (const d of directives) {\n\t\tif (!d.scope) continue;\n\t\tconst key = d.scope.value;\n\t\tconst existing = scopeTargets.get(key);\n\t\tif (existing) {\n\t\t\texisting.push(d);\n\t\t} else {\n\t\t\tscopeTargets.set(key, [d]);\n\t\t}\n\t}\n\n\treturn errors;\n}\n"]}

package/package.json

@@ -0,0 +1,23 @@
+{
+	"name": "@m4ike1/ion-cue",
+	"version": "0.1.0",
+	"type": "module",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "bun test",
+		"prepublishOnly": "npm run clean && npm run build"
+	}
+}