@dotit/core 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,234 @@
+export interface IntentBlock {
+    id: string;
+    type: BlockType;
+    keywordAlias?: string;
+    content: string;
+    originalContent?: string;
+    properties?: Record<string, string | number>;
+    inline?: InlineNode[];
+    children?: IntentBlock[];
+    table?: {
+        headers?: string[];
+        rows: string[][];
+        headersKeyword?: string;
+        rowKeyword?: string;
+    };
+}
+export declare const INTERNAL_BLOCK_TYPES: readonly ["list-item", "step-item", "body-text", "divider", "table", "extension"];
+export declare const KEYWORDS: string[];
+export type BlockType = "title" | "summary" | "section" | "sub" | "divider" | "text" | "info" | "columns" | "row" | "table" | "extension" | "task" | "done" | "ask" | "quote" | "cite" | "image" | "link" | "ref" | "embed" | "code" | "input" | "output" | "list-item" | "step-item" | "body-text" | "step" | "decision" | "trigger" | "loop" | "checkpoint" | "audit" | "error" | "import" | "export" | "progress" | "context" | "tool" | "prompt" | "memory" | "result" | "handoff" | "wait" | "parallel" | "retry" | "gate" | "call" | "signal" | "policy" | "track" | "approve" | "sign" | "freeze" | "revision" | "history" | "meta" | "font" | "page" | "break" | "byline" | "epigraph" | "caption" | "footnote" | "toc" | "dedication" | "header" | "footer" | "watermark" | "style" | "def" | "metric" | "amendment" | "figure" | "signline" | "contact" | "deadline" | "assert" | "secret" | "agent" | "model" | "custom";
+export type InlineNode = {
+    type: "text";
+    value: string;
+} | {
+    type: "bold";
+    value: string;
+} | {
+    type: "italic";
+    value: string;
+} | {
+    type: "strike";
+    value: string;
+} | {
+    type: "inline-quote";
+    value: string;
+} | {
+    type: "highlight";
+    value: string;
+} | {
+    type: "code";
+    value: string;
+} | {
+    type: "inline-note";
+    value: string;
+} | {
+    type: "date";
+    value: string;
+    iso: string;
+} | {
+    type: "mention";
+    value: string;
+} | {
+    type: "tag";
+    value: string;
+} | {
+    type: "label";
+    value: string;
+} | {
+    type: "link";
+    value: string;
+    href: string;
+} | {
+    type: "footnote-ref";
+    value: string;
+} | {
+    type: "styled";
+    value: string;
+    props: Record<string, string>;
+};
+export interface IntentExtension {
+    keywords?: string[];
+    parseBlock?: (args: {
+        keyword: string;
+        content: string;
+        properties?: Record<string, string | number>;
+        line: number;
+        column: number;
+        parseInline: (text: string) => {
+            content: string;
+            inline: InlineNode[];
+        };
+    }) => IntentBlock | null | undefined;
+    parseInline?: (args: {
+        text: string;
+        defaultParseInline: (text: string) => {
+            content: string;
+            inline: InlineNode[];
+        };
+    }) => {
+        content: string;
+        inline: InlineNode[];
+    } | null | undefined;
+    validate?: (document: IntentDocument) => Diagnostic[];
+}
+export interface ParseOptions {
+    extensions?: IntentExtension[];
+    includeHistorySection?: boolean;
+}
+export interface Diagnostic {
+    severity: "error" | "warning";
+    message: string;
+    line: number;
+    column: number;
+    code: "UNTERMINATED_CODE_BLOCK" | "UNEXPECTED_END" | "INVALID_PROPERTY_SEGMENT" | "HEADERS_WITHOUT_ROWS" | "ROW_WITHOUT_HEADERS" | "UNKNOWN_EXTENSION_KEYWORD" | "EXTENSION_VALIDATION" | "REF_MISSING_TARGET" | "REF_MISSING_REL" | "DEF_MISSING_MEANING" | "DEF_DUPLICATE_TERM" | "METRIC_MISSING_VALUE" | "METRIC_INVALID_TREND" | "AMENDMENT_WITHOUT_FREEZE" | "AMENDMENT_MISSING_REF" | "AMENDMENT_MISSING_NOW" | "FIGURE_MISSING_SRC" | "FIGURE_MISSING_CAPTION" | "CONTACT_NO_REACH" | "DEADLINE_MISSING_DATE" | "DEADLINE_PAST" | "LEGACY_HISTORY_BOUNDARY" | "HISTORY_WITHOUT_FREEZE" | "DEPRECATED_KEYWORD" | "CITE_MISSING_TITLE" | "INPUT_MISSING_NAME" | "OUTPUT_MISSING_NAME" | "TOOL_MISSING_API" | "PROMPT_MISSING_CONTENT" | "ASSERT_MISSING_CONDITION" | "SECRET_MISSING_NAME" | "DEPRECATED_PROPERTY";
+}
+export type AgenticStatus = "pending" | "running" | "blocked" | "failed" | "skipped" | "cancelled" | "done" | "approved" | "rejected" | "waiting";
+export interface VariableRef {
+    $ref: string;
+}
+export interface IntentDocumentMetadata {
+    title?: string;
+    summary?: string;
+    language?: "ltr" | "rtl";
+    agent?: string;
+    model?: string;
+    context?: Record<string, string>;
+    version?: string;
+    tracking?: {
+        version: string;
+        by: string;
+        active: boolean;
+    };
+    signatures?: Array<{
+        signer: string;
+        role?: string;
+        at: string;
+        hash: string;
+        valid?: boolean;
+    }>;
+    freeze?: {
+        at: string;
+        hash: string;
+        status: "locked";
+    };
+    meta?: Record<string, string>;
+}
+export interface PrintLayout {
+    page?: IntentBlock;
+    header?: IntentBlock;
+    footer?: IntentBlock;
+    watermark?: IntentBlock;
+    breaks: IntentBlock[];
+}
+export interface IntentDocument {
+    version?: string;
+    blocks: IntentBlock[];
+    metadata?: IntentDocumentMetadata;
+    diagnostics?: Diagnostic[];
+    history?: HistorySection;
+}
+export interface HistorySection {
+    registry: RegistryEntry[];
+    revisions: RevisionEntry[];
+    raw: string;
+}
+export interface RegistryEntry {
+    id: string;
+    blockType: string;
+    section: string;
+    fingerprint: string;
+    dead?: boolean;
+}
+export interface RevisionEntry {
+    version: string;
+    at: string;
+    by: string;
+    change: "added" | "removed" | "modified" | "moved";
+    id: string;
+    block: string;
+    section?: string;
+    was?: string;
+    now?: string;
+    wasSection?: string;
+    nowSection?: string;
+}
+export interface QueryClause {
+    field: string;
+    operator: "=" | "!=" | "<" | ">" | "<=" | ">=" | "contains" | "startsWith" | "exists";
+    value?: string | number | boolean;
+}
+export interface QuerySort {
+    field: string;
+    direction: "asc" | "desc";
+}
+export interface QueryOptions {
+    where?: QueryClause[];
+    sort?: QuerySort[];
+    limit?: number;
+    offset?: number;
+}
+export interface QueryResult {
+    blocks: IntentBlock[];
+    total: number;
+    matched: number;
+}
+export interface PropertySchema {
+    type: "string" | "number" | "boolean" | "date" | "enum" | "url" | "email";
+    required?: boolean;
+    default?: string | number | boolean;
+    enumValues?: string[];
+    pattern?: string;
+    min?: number;
+    max?: number;
+    format?: "iso-date" | "iso-datetime" | "time" | "url" | "email";
+}
+export interface BlockSchema {
+    type: BlockType;
+    content?: {
+        required?: boolean;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+    };
+    properties?: Record<string, PropertySchema>;
+    allowUnknownProperties?: boolean;
+}
+export interface DocumentSchema {
+    name: string;
+    description?: string;
+    requiredBlocks?: BlockType[];
+    blockSchemas?: Record<string, BlockSchema>;
+    allowUnknownBlocks?: boolean;
+}
+export interface ValidationError {
+    blockId: string;
+    blockType: string;
+    field: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}

package/dist/types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEYWORDS = exports.INTERNAL_BLOCK_TYPES = void 0;
+const language_registry_1 = require("./language-registry");
+exports.INTERNAL_BLOCK_TYPES = [
+    "list-item",
+    "step-item",
+    "body-text",
+    "divider",
+    "table",
+    "extension",
+];
+exports.KEYWORDS = [
+    ...language_registry_1.CANONICAL_KEYWORDS,
+    ...Object.keys(language_registry_1.ALIAS_MAP),
+    ...language_registry_1.EXTENSION_KEYWORDS,
+    ...Object.keys(language_registry_1.EXTENSION_LEGACY_ALIASES),
+    ...language_registry_1.COMPAT_KEYWORDS,
+];

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+import { IntentBlock } from "./types";
+export declare function flattenBlocks(blocks: IntentBlock[]): IntentBlock[];

package/dist/utils.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenBlocks = flattenBlocks;
+function flattenBlocks(blocks) {
+    const result = [];
+    for (const block of blocks) {
+        result.push(block);
+        if (block.children) {
+            result.push(...flattenBlocks(block.children));
+        }
+    }
+    return result;
+}

package/dist/validate.d.ts

@@ -0,0 +1,13 @@
+import { IntentDocument } from "./types";
+export interface SemanticIssue {
+    blockId: string;
+    blockType: string;
+    type: "error" | "warning" | "info";
+    code: string;
+    message: string;
+}
+export interface SemanticValidationResult {
+    valid: boolean;
+    issues: SemanticIssue[];
+}
+export declare function validateDocumentSemantic(doc: IntentDocument): SemanticValidationResult;