@glyphjs/types 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Glyph JS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @glyphjs/types
+
+Shared TypeScript type definitions for the Glyph JS ecosystem.
+
+## Install
+
+```bash
+pnpm add @glyphjs/types
+```
+
+## Usage
+
+```ts
+import type { GlyphIR, Block, CompilationResult } from '@glyphjs/types';
+
+const doc: GlyphIR = {
+  version: '0.1',
+  documentId: 'doc-1',
+  metadata: { title: 'Hello' },
+  blocks: [],
+  references: [],
+};
+```
+
+## What's included
+
+- **IR types** -- `GlyphIR`, `Block`, `Reference`, `CompilationResult`, and related interfaces
+- **AST types** -- `GlyphRoot`, `GlyphUIBlock`, `RawRef` for the parsed markdown AST
+- **Block data types** -- `HeadingData`, `ParagraphData`, `CodeData`, `ListData`, and more
+- **Patch types** -- `GlyphPatch`, `GlyphPatchOperation` for IR diffing/patching
+- **Runtime types** -- `GlyphRuntime`, `GlyphTheme`, `BlockProps`, `GlyphRuntimeConfig`
+- **Plugin types** -- `GlyphComponentDefinition`, `GlyphComponentProps`
+
+## Docs
+
+https://github.com/VledicFranco/glyphjs

package/dist/ast.d.ts

@@ -0,0 +1,43 @@
+import type { SourcePosition } from './ir.js';
+export interface RawRef {
+    target: string;
+    type?: string;
+    label?: string;
+    sourceAnchor?: string;
+    targetAnchor?: string;
+    bidirectional?: boolean;
+}
+export interface GlyphUIBlock {
+    type: 'glyphUIBlock';
+    componentType: string;
+    rawYaml: string;
+    parsedData: Record<string, unknown> | null;
+    yamlError?: string;
+    glyphId?: string;
+    refs?: RawRef[];
+    position: SourcePosition;
+}
+/**
+ * The Glyph AST root node. Extends the standard MDAST Root
+ * with GlyphUIBlock nodes mixed into the children array.
+ *
+ * We use a structural type rather than extending MdastRoot directly
+ * to avoid a hard dependency on @types/mdast in this package.
+ */
+export interface GlyphRoot {
+    type: 'root';
+    children: (GlyphUIBlock | MdastContentNode)[];
+}
+/**
+ * Represents any standard MDAST content node.
+ * This is a loose type — the actual MDAST types are richer,
+ * but we only need this for the union in GlyphRoot.
+ */
+export interface MdastContentNode {
+    type: string;
+    children?: unknown[];
+    value?: string;
+    position?: SourcePosition;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=ast.d.ts.map

package/dist/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAID;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,YAAY,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/block-data.d.ts

@@ -0,0 +1,64 @@
+export type InlineNode = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'strong';
+    children: InlineNode[];
+} | {
+    type: 'emphasis';
+    children: InlineNode[];
+} | {
+    type: 'delete';
+    children: InlineNode[];
+} | {
+    type: 'inlineCode';
+    value: string;
+} | {
+    type: 'link';
+    url: string;
+    title?: string;
+    children: InlineNode[];
+} | {
+    type: 'image';
+    src: string;
+    alt?: string;
+    title?: string;
+} | {
+    type: 'break';
+};
+export interface HeadingData {
+    depth: 1 | 2 | 3 | 4 | 5 | 6;
+    children: InlineNode[];
+}
+export interface ParagraphData {
+    children: InlineNode[];
+}
+export interface ListData {
+    ordered: boolean;
+    start?: number;
+    items: ListItemData[];
+}
+export interface ListItemData {
+    children: InlineNode[];
+    subList?: ListData;
+}
+export interface CodeData {
+    language?: string;
+    value: string;
+    meta?: string;
+}
+export interface BlockquoteData {
+    children: InlineNode[];
+}
+export interface ImageData {
+    src: string;
+    alt?: string;
+    title?: string;
+}
+export interface ThematicBreakData {
+}
+export interface HtmlData {
+    value: string;
+}
+export type BlockData = HeadingData | ParagraphData | ListData | CodeData | BlockquoteData | ImageData | ThematicBreakData | HtmlData | Record<string, unknown>;
+//# sourceMappingURL=block-data.d.ts.map

package/dist/block-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-data.d.ts","sourceRoot":"","sources":["../src/block-data.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAItB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,iBAAiB;CAEjC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/container.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Container-width tier resolved from measured pixel width.
+ * - `compact`: < 500px — chat sidebars, mobile, narrow panels
+ * - `standard`: 500–899px — docs sites, split-pane editors
+ * - `wide`: ≥ 900px — dashboards, full-width, presentations
+ */
+export type ContainerTier = 'compact' | 'standard' | 'wide';
+/**
+ * Container measurement context injected into every component via props.
+ * The runtime measures the document container via ResizeObserver and
+ * resolves the tier using hysteresis to prevent layout thrashing.
+ */
+export interface ContainerContext {
+    /** Measured container width in CSS pixels. 0 before first measurement. */
+    width: number;
+    /** Resolved breakpoint tier. Defaults to `'wide'` when width is 0. */
+    tier: ContainerTier;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,EAAE,aAAa,CAAC;CACrB"}

package/dist/diagnostic.d.ts

@@ -0,0 +1,11 @@
+import type { SourcePosition } from './ir.js';
+export type DiagnosticSource = 'parser' | 'compiler' | 'schema' | 'runtime' | 'plugin';
+export interface Diagnostic {
+    severity: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    position?: SourcePosition;
+    source: DiagnosticSource;
+    details?: unknown;
+}
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/graph.d.ts

@@ -0,0 +1,16 @@
+export interface GraphNode {
+    id: string;
+    label: string;
+    type?: string;
+    style?: Record<string, string>;
+    group?: string;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    label?: string;
+    type?: string;
+    cardinality?: '1:1' | '1:N' | 'N:1' | 'N:M';
+    style?: Record<string, string>;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { InlineNode, HeadingData, ParagraphData, ListData, ListItemData, CodeData, BlockquoteData, ImageData, ThematicBreakData, HtmlData, BlockData, } from './block-data.js';
+export type { SourcePosition, BlockType, Block, ReferenceType, Reference, DocumentMetadata, BlockLayoutOverride, LayoutHints, LayoutSemantic, GlyphIR, CompilationResult, } from './ir.js';
+export type { RawRef, GlyphUIBlock, GlyphRoot, MdastContentNode } from './ast.js';
+export type { GlyphPatchOperation, GlyphPatch } from './patch.js';
+export type { IRMigration } from './migration.js';
+export type { DiagnosticSource, Diagnostic } from './diagnostic.js';
+export type { GlyphComponentDefinition, GlyphComponentProps, ComponentType } from './plugin.js';
+export type { GlyphTheme, GlyphThemeContext, BlockProps, AnimationConfig, GlyphRuntimeConfig, GlyphRuntime, } from './runtime.js';
+export type { ContainerTier, ContainerContext } from './container.js';
+export type { GraphNode, GraphEdge } from './graph.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,cAAc,EACd,SAAS,EACT,KAAK,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,OAAO,EACP,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGlF,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGlE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGpE,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhG,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGtE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/ir.d.ts

@@ -0,0 +1,71 @@
+import type { BlockData } from './block-data.js';
+import type { Diagnostic } from './diagnostic.js';
+export interface SourcePosition {
+    start: {
+        line: number;
+        column: number;
+        offset?: number;
+    };
+    end: {
+        line: number;
+        column: number;
+        offset?: number;
+    };
+}
+export type BlockType = 'heading' | 'paragraph' | 'list' | 'code' | 'blockquote' | 'thematic-break' | 'image' | 'html' | 'ui:graph' | 'ui:table' | 'ui:chart' | 'ui:relation' | 'ui:timeline' | 'ui:callout' | 'ui:tabs' | 'ui:steps' | 'ui:kpi' | 'ui:accordion' | 'ui:comparison' | 'ui:codediff' | 'ui:flowchart' | 'ui:filetree' | 'ui:sequence' | 'ui:mindmap' | 'ui:equation' | 'ui:quiz' | 'ui:card' | 'ui:infographic' | `ui:${string}`;
+export interface Block {
+    id: string;
+    type: BlockType;
+    data: BlockData;
+    position: SourcePosition;
+    children?: Block[];
+    diagnostics?: Diagnostic[];
+    metadata?: Record<string, unknown>;
+}
+export type ReferenceType = 'navigates-to' | 'details' | 'depends-on' | 'data-source' | `custom:${string}`;
+export interface Reference {
+    id: string;
+    type: ReferenceType;
+    sourceBlockId: string;
+    targetBlockId: string;
+    sourceAnchor?: string;
+    targetAnchor?: string;
+    label?: string;
+    bidirectional?: boolean;
+    unresolved?: boolean;
+}
+export interface DocumentMetadata {
+    title?: string;
+    description?: string;
+    authors?: string[];
+    createdAt?: string;
+    sourceFile?: string;
+    tags?: string[];
+}
+export interface BlockLayoutOverride {
+    gridColumn?: string;
+    gridRow?: string;
+    span?: number;
+}
+export interface LayoutHints {
+    mode: 'document' | 'dashboard' | 'presentation';
+    columns?: number;
+    maxWidth?: string;
+    spacing?: 'compact' | 'normal' | 'relaxed';
+    blockLayout?: Record<string, BlockLayoutOverride>;
+}
+export type LayoutSemantic = 'top-down' | 'left-right' | 'bottom-up' | 'radial' | 'force';
+export interface GlyphIR {
+    version: string;
+    id: string;
+    metadata: DocumentMetadata;
+    blocks: Block[];
+    references: Reference[];
+    layout: LayoutHints;
+}
+export interface CompilationResult {
+    ir: GlyphIR;
+    diagnostics: Diagnostic[];
+    hasErrors: boolean;
+}
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}

package/dist/migration.d.ts

@@ -0,0 +1,7 @@
+import type { GlyphIR } from './ir.js';
+export interface IRMigration {
+    from: string;
+    to: string;
+    migrate: (ir: GlyphIR) => GlyphIR;
+}
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC;CACnC"}

package/dist/patch.d.ts

@@ -0,0 +1,31 @@
+import type { Block, DocumentMetadata, LayoutHints, Reference } from './ir.js';
+export type GlyphPatchOperation = {
+    op: 'addBlock';
+    block: Block;
+    afterBlockId?: string;
+} | {
+    op: 'removeBlock';
+    blockId: string;
+} | {
+    op: 'updateBlock';
+    blockId: string;
+    data: Partial<Block>;
+} | {
+    op: 'moveBlock';
+    blockId: string;
+    afterBlockId?: string;
+} | {
+    op: 'addReference';
+    reference: Reference;
+} | {
+    op: 'removeReference';
+    referenceId: string;
+} | {
+    op: 'updateMetadata';
+    metadata: Partial<DocumentMetadata>;
+} | {
+    op: 'updateLayout';
+    layout: Partial<LayoutHints>;
+};
+export type GlyphPatch = GlyphPatchOperation[];
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAI/E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,38 @@
+import type { Block, LayoutHints, Reference } from './ir.js';
+import type { GlyphThemeContext } from './runtime.js';
+import type { ContainerContext } from './container.js';
+/**
+ * Definition for a Glyph UI component plugin.
+ * The `schema` field uses Zod but is typed loosely here to avoid
+ * a hard dependency on zod in this type-only package.
+ */
+export interface GlyphComponentDefinition<T = unknown> {
+    type: `ui:${string}`;
+    schema: {
+        parse: (data: unknown) => T;
+        safeParse: (data: unknown) => {
+            success: boolean;
+            data?: T;
+            error?: unknown;
+        };
+    };
+    render: ComponentType<GlyphComponentProps<T>>;
+    themeDefaults?: Record<string, string>;
+    dependencies?: string[];
+}
+export interface GlyphComponentProps<T = unknown> {
+    data: T;
+    block: Block;
+    outgoingRefs: Reference[];
+    incomingRefs: Reference[];
+    onNavigate: (ref: Reference) => void;
+    theme: GlyphThemeContext;
+    layout: LayoutHints;
+    container: ContainerContext;
+}
+/**
+ * Minimal React component type to avoid depending on @types/react.
+ * Compatible with React.ComponentType<P>.
+ */
+export type ComponentType<P = {}> = ((props: P) => unknown) | (new (props: P) => unknown);
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,OAAO;IACnD,IAAI,EAAE,MAAM,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC;QAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KAC/E,CAAC;IACF,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,UAAU,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;GAGG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,43 @@
+import type { Block, GlyphIR, LayoutHints, Reference } from './ir.js';
+import type { Diagnostic } from './diagnostic.js';
+import type { ComponentType, GlyphComponentDefinition } from './plugin.js';
+export interface GlyphTheme {
+    name: string;
+    variables: Record<string, string>;
+}
+export interface GlyphThemeContext {
+    name: string;
+    resolveVar: (varName: string) => string;
+    isDark: boolean;
+}
+export interface BlockProps {
+    block: Block;
+    layout: LayoutHints;
+}
+export interface AnimationConfig {
+    /** Whether animations are enabled. Defaults to `true`. */
+    enabled?: boolean;
+    /** Base duration in milliseconds. Defaults to `300`. */
+    duration?: number;
+    /** CSS easing function. Defaults to `'ease-out'`. */
+    easing?: string;
+    /** Stagger delay between consecutive blocks in milliseconds. Defaults to `50`. */
+    staggerDelay?: number;
+}
+export interface GlyphRuntimeConfig {
+    components?: GlyphComponentDefinition[];
+    overrides?: Partial<Record<string, ComponentType<BlockProps>>>;
+    theme?: 'light' | 'dark' | GlyphTheme;
+    animation?: AnimationConfig;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+    onNavigate?: (ref: Reference, targetBlock: Block) => void;
+}
+export interface GlyphRuntime {
+    GlyphDocument: ComponentType<{
+        ir: GlyphIR;
+        className?: string;
+    }>;
+    registerComponent(definition: GlyphComponentDefinition): void;
+    setTheme(theme: 'light' | 'dark' | GlyphTheme): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAI3E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;CACjB;AAID,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAID,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/D,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IACtC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC;CAC3D;AAID,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,iBAAiB,CAAC,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;CACtD"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@glyphjs/types",
+  "version": "0.1.0",
+  "description": "Shared TypeScript type definitions for Glyph JS",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "license": "MIT",
+  "author": "Vledic Franco",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VledicFranco/glyphjs.git",
+    "directory": "packages/types"
+  },
+  "homepage": "https://github.com/VledicFranco/glyphjs#readme",
+  "bugs": "https://github.com/VledicFranco/glyphjs/issues",
+  "keywords": [
+    "glyph",
+    "glyphjs",
+    "markdown",
+    "react",
+    "ui-components",
+    "interactive-documents",
+    "typescript",
+    "types"
+  ],
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly --outDir dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist .turbo"
+  }
+}