@soulcraft/sdk 1.4.8 → 1.4.9

package/dist/modules/formats/types.d.ts

@@ -2,12 +2,7 @@
  * @module formats/types
  * @description Soulcraft portable content format type definitions.
  *
- * These types mirror `@soulcraft/formats` exactly. Once `@soulcraft/formats`
- * ships compiled `.d.ts` output (rather than raw `.ts` source), this module
- * can be replaced with simple re-exports. Until then, the types live here
- * to avoid pulling `@soulcraft/formats`' Zod schemas into the SDK's type-check.
- *
- * See: handoff action "Remove duplicate format types from SDK src/modules/formats/"
+ * All types are re-exported from `@soulcraft/formats` (compiled dist/).
  *
  * | Format  | Extension        | Purpose                                      |
  * |---------|------------------|----------------------------------------------|
@@ -16,39 +11,10 @@
  * | WSLIDE  | `.wslide.json`   | Slide deck presentations                     |
  * | WQUIZ   | `.wquiz.json`    | Assessments and quizzes                      |
  */
-export type { WvizDocument, WvizEntity, WvizEdge, WvizSnapshot, WvizViewType, } from './wviz.js';
+export type { WvizDocument, WvizEntity, WvizEdge, WvizSnapshot, WvizViewType } from './wviz.js';
 export type { WdocDocument, WdocMeta, WdocBlock, WdocInlineContent, WdocTextNode, WdocMark, WdocParagraphBlock, WdocHeadingBlock, WdocBlockquoteBlock, WdocCodeBlock, WdocBulletListBlock, WdocOrderedListBlock, WdocListItemBlock, WdocTaskListBlock, WdocTaskItemBlock, WdocImageBlock, WdocVideoBlock, WdocIconBlock, WdocSvgEmbedBlock, WdocEmbedBlock, WdocTableBlock, WdocTableRowBlock, WdocTableCellBlock, WdocTableHeaderBlock, WdocHorizontalRuleBlock, WdocCalloutBlock, } from './wdoc.js';
-export type { WslideDocument, WslideSlide, WslideBackground, WslideLayout, WslideTransition, WslideConfig, } from './wslide.js';
-export type { WquizDocument, WquizQuestion, WquizQuestionType, WquizAnswer, WquizScoringRules, } from './wquiz.js';
-/**
- * Discriminant string identifying the Soulcraft document format.
- *
- * Stored as the `format` field on every document. Use this for narrowing:
- * ```typescript
- * if (doc.format === 'wdoc') { ... }
- * ```
- */
-export type SoulcraftFormat = 'wviz' | 'wdoc' | 'wslide' | 'wquiz';
-/**
- * All Soulcraft format strings as a const array — useful for validation.
- *
- * @example
- * ```typescript
- * const isKnownFormat = (s: string): s is SoulcraftFormat =>
- *   (SOULCRAFT_FORMATS as readonly string[]).includes(s)
- * ```
- */
-export declare const SOULCRAFT_FORMATS: readonly ["wviz", "wdoc", "wslide", "wquiz"];
-/**
- * Minimal base shape shared by all Soulcraft format documents.
- *
- * Every Soulcraft document has a `format` discriminant and a `version` string.
- * Cast an unknown JSON object to this type first, then narrow by `format`.
- */
-export interface SoulcraftFormatDocument {
-    /** Format discriminant. Use to narrow to the specific document type. */
-    format: SoulcraftFormat;
-    /** Schema version string (e.g. `'1.0'`). */
-    version: string;
-}
+export type { WslideDocument, WslideSlide, WslideBackground, WslideLayout, WslideTransition, WslideConfig } from './wslide.js';
+export type { WquizDocument, WquizQuestion, WquizQuestionType, WquizAnswer, WquizScoringRules } from './wquiz.js';
+export type { SoulcraftFormat, SoulcraftFormatDocument } from '@soulcraft/formats';
+export { SOULCRAFT_FORMATS } from '@soulcraft/formats';
 //# sourceMappingURL=types.d.ts.map

package/dist/modules/formats/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAMnB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,8CAAoF,CAAA;AAElH;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,MAAM,EAAE,eAAe,CAAA;IACvB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE/F,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAElB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9H,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAMjH,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/modules/formats/types.js

@@ -2,12 +2,7 @@
  * @module formats/types
  * @description Soulcraft portable content format type definitions.
  *
- * These types mirror `@soulcraft/formats` exactly. Once `@soulcraft/formats`
- * ships compiled `.d.ts` output (rather than raw `.ts` source), this module
- * can be replaced with simple re-exports. Until then, the types live here
- * to avoid pulling `@soulcraft/formats`' Zod schemas into the SDK's type-check.
- *
- * See: handoff action "Remove duplicate format types from SDK src/modules/formats/"
+ * All types are re-exported from `@soulcraft/formats` (compiled dist/).
  *
  * | Format  | Extension        | Purpose                                      |
  * |---------|------------------|----------------------------------------------|
@@ -16,14 +11,5 @@
  * | WSLIDE  | `.wslide.json`   | Slide deck presentations                     |
  * | WQUIZ   | `.wquiz.json`    | Assessments and quizzes                      |
  */
-/**
- * All Soulcraft format strings as a const array — useful for validation.
- *
- * @example
- * ```typescript
- * const isKnownFormat = (s: string): s is SoulcraftFormat =>
- *   (SOULCRAFT_FORMATS as readonly string[]).includes(s)
- * ```
- */
-export const SOULCRAFT_FORMATS = ['wviz', 'wdoc', 'wslide', 'wquiz'];
+export { SOULCRAFT_FORMATS } from '@soulcraft/formats';
 //# sourceMappingURL=types.js.map

package/dist/modules/formats/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/formats/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAA+C,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/formats/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0CH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/modules/formats/wdoc.d.ts

@@ -1,263 +1,10 @@
 /**
  * @module formats/wdoc
- * @description Type definitions for the WDOC (Workshop Document) format.
+ * @description Re-exports WDOC types from `@soulcraft/formats`.
  *
  * WDOC is a block-based JSON document format compatible with the TipTap/ProseMirror
- * document schema. It extends plain Markdown with rich content blocks (video, icon,
- * table, callout, embed) and is the native format for Workshop's document editor.
- *
- * WDOC files are stored in the VFS with the `.wdoc` extension. The format is a
- * strict superset of Markdown — all Markdown content can be represented as WDOC,
- * but not vice versa.
- *
- * @example Reading a WDOC from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/projects/my-project/README.wdoc')
- * const doc: WdocDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(doc.meta.title)
- * ```
- */
-/**
- * A WDOC document — the top-level container for all block content.
- */
-export interface WdocDocument {
-    /** Format discriminator. Always `'doc'`. */
-    type: 'doc';
-    /** Schema version. Currently `'1.0'`. */
-    version: string;
-    /** Document metadata (title, author, timestamps, tags). */
-    meta: WdocMeta;
-    /** Ordered list of content blocks. */
-    content: WdocBlock[];
-}
-/**
- * Document-level metadata stored in the WDOC header.
- */
-export interface WdocMeta {
-    /** Human-readable document title. */
-    title?: string;
-    /** Template ID this document was created from. */
-    template?: string;
-    /** ISO 8601 creation timestamp. */
-    created?: string;
-    /** ISO 8601 last-modified timestamp. */
-    modified?: string;
-    /** Document author (user ID or display name). */
-    author?: string;
-    /** Arbitrary tags for categorization. */
-    tags?: string[];
-    /** Whether this document was assembled from multiple source files. */
-    merged?: boolean;
-    /** Number of source files when `merged` is true. */
-    sourceCount?: number;
-}
-/**
- * A text leaf node with optional formatting marks.
- */
-export interface WdocTextNode {
-    type: 'text';
-    /** The raw text content. */
-    text: string;
-    /** Applied inline formatting marks. */
-    marks?: WdocMark[];
-}
-/**
- * An inline formatting mark applied to a text node.
- */
-export type WdocMark = {
-    type: 'bold';
-} | {
-    type: 'italic';
-} | {
-    type: 'strike';
-} | {
-    type: 'code';
-} | {
-    type: 'underline';
-} | {
-    type: 'link';
-    attrs: {
-        href: string;
-        target?: string;
-    };
-} | {
-    type: 'highlight';
-    attrs?: {
-        color?: string;
-    };
-} | {
-    type: 'textStyle';
-    attrs?: {
-        color?: string;
-        fontSize?: string;
-    };
-};
-/** Inline content — text nodes or inline icon blocks. */
-export type WdocInlineContent = WdocTextNode | WdocIconBlock;
-/**
- * Union of all block types that can appear in a WDOC document.
+ * document schema. It is the native format for Workshop's document editor and is
+ * stored in the VFS with the `.wdoc` extension.
  */
-export type WdocBlock = WdocParagraphBlock | WdocHeadingBlock | WdocBlockquoteBlock | WdocCodeBlock | WdocBulletListBlock | WdocOrderedListBlock | WdocListItemBlock | WdocTaskListBlock | WdocTaskItemBlock | WdocImageBlock | WdocVideoBlock | WdocIconBlock | WdocSvgEmbedBlock | WdocEmbedBlock | WdocTableBlock | WdocTableRowBlock | WdocTableCellBlock | WdocTableHeaderBlock | WdocHorizontalRuleBlock | WdocCalloutBlock;
-/** A paragraph block. */
-export interface WdocParagraphBlock {
-    type: 'paragraph';
-    attrs?: {
-        textAlign?: 'left' | 'center' | 'right' | 'justify';
-    };
-    content?: WdocInlineContent[];
-}
-/** A heading block (H1–H6). */
-export interface WdocHeadingBlock {
-    type: 'heading';
-    attrs: {
-        level: 1 | 2 | 3 | 4 | 5 | 6;
-        textAlign?: 'left' | 'center' | 'right';
-    };
-    content?: WdocInlineContent[];
-}
-/** A block quotation. */
-export interface WdocBlockquoteBlock {
-    type: 'blockquote';
-    content?: WdocBlock[];
-}
-/** A fenced code block with optional language syntax highlighting. */
-export interface WdocCodeBlock {
-    type: 'codeBlock';
-    attrs?: {
-        language?: string;
-    };
-    content?: WdocTextNode[];
-}
-/** An unordered (bullet) list. */
-export interface WdocBulletListBlock {
-    type: 'bulletList';
-    content?: WdocListItemBlock[];
-}
-/** An ordered (numbered) list. */
-export interface WdocOrderedListBlock {
-    type: 'orderedList';
-    attrs?: {
-        start?: number;
-    };
-    content?: WdocListItemBlock[];
-}
-/** A single list item (used in both bullet and ordered lists). */
-export interface WdocListItemBlock {
-    type: 'listItem';
-    content?: WdocBlock[];
-}
-/** A task/checklist. */
-export interface WdocTaskListBlock {
-    type: 'taskList';
-    content?: WdocTaskItemBlock[];
-}
-/** A single task item with a checked/unchecked state. */
-export interface WdocTaskItemBlock {
-    type: 'taskItem';
-    attrs: {
-        checked: boolean;
-    };
-    content?: WdocBlock[];
-}
-/** A horizontal rule divider. */
-export interface WdocHorizontalRuleBlock {
-    type: 'horizontalRule';
-}
-/** An image block. */
-export interface WdocImageBlock {
-    type: 'image';
-    attrs: {
-        src: string;
-        alt?: string;
-        title?: string;
-        width?: number;
-        height?: number;
-    };
-}
-/** A video block (self-hosted or embedded). */
-export interface WdocVideoBlock {
-    type: 'video';
-    attrs: {
-        src: string;
-        provider?: 'youtube' | 'vimeo' | 'self-hosted';
-        poster?: string;
-        title?: string;
-        width?: number;
-        height?: number;
-    };
-}
-/** An inline icon from the Iconify library. */
-export interface WdocIconBlock {
-    type: 'icon';
-    attrs: {
-        /** Iconify icon identifier, e.g. `'mdi:rocket-launch'`. */
-        icon: string;
-        size?: number;
-        color?: string;
-    };
-    marks?: WdocMark[];
-}
-/** An SVG file embed. */
-export interface WdocSvgEmbedBlock {
-    type: 'svgEmbed';
-    attrs: {
-        /** Path to the `.svg` file in the VFS. */
-        src: string;
-        editable?: boolean;
-        /** When true, inline the SVG content rather than referencing it. */
-        inline?: boolean;
-        width?: number;
-        height?: number;
-    };
-    /** Inlined SVG markup when `attrs.inline` is true. */
-    content?: string;
-}
-/** An oEmbed/iframe embed (Twitter, Figma, CodePen, etc.). */
-export interface WdocEmbedBlock {
-    type: 'embed';
-    attrs: {
-        url: string;
-        provider?: 'twitter' | 'figma' | 'codepen' | 'youtube' | 'gist' | 'other';
-        width?: number;
-        height?: number;
-    };
-}
-/** A table block. */
-export interface WdocTableBlock {
-    type: 'table';
-    content?: WdocTableRowBlock[];
-}
-/** A table row. */
-export interface WdocTableRowBlock {
-    type: 'tableRow';
-    content?: (WdocTableCellBlock | WdocTableHeaderBlock)[];
-}
-/** A table body cell. */
-export interface WdocTableCellBlock {
-    type: 'tableCell';
-    attrs?: {
-        colspan?: number;
-        rowspan?: number;
-    };
-    content?: WdocBlock[];
-}
-/** A table header cell. */
-export interface WdocTableHeaderBlock {
-    type: 'tableHeader';
-    attrs?: {
-        colspan?: number;
-        rowspan?: number;
-    };
-    content?: WdocBlock[];
-}
-/** A styled callout/alert block. */
-export interface WdocCalloutBlock {
-    type: 'callout';
-    attrs: {
-        variant: 'info' | 'warning' | 'success' | 'error' | 'tip';
-        /** Optional Iconify icon override. */
-        icon?: string;
-    };
-    content?: WdocBlock[];
-}
+export type { WdocDocument, WdocMeta, WdocBlock, WdocInlineContent, WdocTextNode, WdocMark, WdocParagraphBlock, WdocHeadingBlock, WdocBlockquoteBlock, WdocCodeBlock, WdocBulletListBlock, WdocOrderedListBlock, WdocListItemBlock, WdocTaskListBlock, WdocTaskItemBlock, WdocImageBlock, WdocVideoBlock, WdocIconBlock, WdocSvgEmbedBlock, WdocEmbedBlock, WdocTableBlock, WdocTableRowBlock, WdocTableCellBlock, WdocTableHeaderBlock, WdocHorizontalRuleBlock, WdocCalloutBlock, } from '@soulcraft/formats/wdoc';
 //# sourceMappingURL=wdoc.d.ts.map

package/dist/modules/formats/wdoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wdoc.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wdoc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wdoc.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA"}

package/dist/modules/formats/wdoc.js

@@ -1,21 +1,10 @@
 /**
  * @module formats/wdoc
- * @description Type definitions for the WDOC (Workshop Document) format.
+ * @description Re-exports WDOC types from `@soulcraft/formats`.
  *
  * WDOC is a block-based JSON document format compatible with the TipTap/ProseMirror
- * document schema. It extends plain Markdown with rich content blocks (video, icon,
- * table, callout, embed) and is the native format for Workshop's document editor.
- *
- * WDOC files are stored in the VFS with the `.wdoc` extension. The format is a
- * strict superset of Markdown — all Markdown content can be represented as WDOC,
- * but not vice versa.
- *
- * @example Reading a WDOC from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/projects/my-project/README.wdoc')
- * const doc: WdocDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(doc.meta.title)
- * ```
+ * document schema. It is the native format for Workshop's document editor and is
+ * stored in the VFS with the `.wdoc` extension.
  */
 export {};
 //# sourceMappingURL=wdoc.js.map

package/dist/modules/formats/wdoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"wdoc.js","sourceRoot":"","sources":["../../../src/modules/formats/wdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"wdoc.js","sourceRoot":"","sources":["../../../src/modules/formats/wdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/modules/formats/wquiz.d.ts

@@ -1,122 +1,11 @@
 /**
  * @module formats/wquiz
- * @description Type definitions for the WQUIZ (Workshop Quiz) document format.
+ * @description Re-exports WQUIZ types from `@soulcraft/formats`.
  *
  * WQUIZ documents are portable assessment and quiz definitions. They support
- * multiple-choice, true/false, short-answer, and essay question types, with
- * per-question point values, optional explanations, and configurable scoring.
- *
- * WQUIZ files are stored in the VFS with the `.wquiz.json` extension. Academy
- * uses them for module assessments; Workshop can render them for self-check quizzes.
- *
- * Question content supports rich formatting via WDOC blocks, enabling code
- * snippets, images, and callouts inside questions and answer choices.
- *
- * @example Reading a WQUIZ from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/assessments/module-1.wquiz.json')
- * const quiz: WquizDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(`${quiz.questions.length} questions, ${quiz.scoring.totalPoints} points`)
- * ```
- */
-import type { WdocBlock } from './wdoc.js';
-/**
- * A WQUIZ assessment document.
- */
-export interface WquizDocument {
-    /** Format discriminator. Always `'wquiz'`. */
-    format: 'wquiz';
-    /** Schema version. Currently `'1.0'`. */
-    version: '1.0';
-    /** Quiz title. */
-    title: string;
-    /** Optional description shown to the learner before starting. */
-    description?: string;
-    /** ISO 8601 creation timestamp. */
-    createdAt?: string;
-    /** ISO 8601 last-modified timestamp. */
-    updatedAt?: string;
-    /** Ordered list of questions. */
-    questions: WquizQuestion[];
-    /** Scoring configuration. */
-    scoring: WquizScoringRules;
-    /** Optional metadata for product-specific use (e.g. Academy module ID). */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Question type discriminant.
- *
- * - `multiple-choice` — One or more correct answers from a fixed list
- * - `true-false` — Binary correct/incorrect assertion
- * - `short-answer` — Free-text response, graded by exact match or AI review
- * - `essay` — Long-form free-text response, graded by human or AI review
- */
-export type WquizQuestionType = 'multiple-choice' | 'true-false' | 'short-answer' | 'essay';
-/**
- * A single quiz question.
- */
-export interface WquizQuestion {
-    /** Stable unique identifier for this question. */
-    id: string;
-    /** Question type. */
-    type: WquizQuestionType;
-    /** Plain-text question stem (used as fallback when `content` is absent). */
-    text: string;
-    /** Rich-text question content (WDOC blocks). When present, rendered instead of `text`. */
-    content?: WdocBlock[];
-    /** Available answer choices (for `multiple-choice` and `true-false` types). */
-    answers: WquizAnswer[];
-    /**
-     * IDs of correct answer choices.
-     * - For `multiple-choice`: one or more answer IDs.
-     * - For `true-false`: one of the two generated answer IDs.
-     * - For `short-answer`: the accepted text strings (exact match).
-     * - For `essay`: omit; graded externally.
-     */
-    correct?: string[];
-    /** Explanation shown after the learner answers (Markdown or plain text). */
-    explanation?: string;
-    /** Point value for this question. Defaults to `1`. */
-    points?: number;
-    /** Whether to randomize the order of `answers` when presenting. Defaults to `false`. */
-    shuffleAnswers?: boolean;
-}
-/**
- * A single answer choice within a question.
- */
-export interface WquizAnswer {
-    /** Stable unique identifier for this answer choice. */
-    id: string;
-    /** Plain-text answer label (used as fallback when `content` is absent). */
-    text: string;
-    /** Rich-text answer content (WDOC blocks). When present, rendered instead of `text`. */
-    content?: WdocBlock[];
-    /** Per-choice feedback shown after the learner answers. */
-    feedback?: string;
-    /**
-     * Partial-credit weight (0–1) for this answer choice.
-     * Only used when `WquizScoringRules.allowPartialCredit` is `true`.
-     * A weight of `1.0` means full credit; `0.5` means half credit.
-     */
-    weight?: number;
-}
-/**
- * Scoring rules for the entire quiz.
+ * multiple-choice, true/false, short-answer, and essay question types with
+ * per-question point values and configurable scoring. Stored in the VFS with
+ * the `.wquiz.json` extension; used by Academy for module assessments.
  */
-export interface WquizScoringRules {
-    /** Minimum score (as a percentage 0–100) required to pass. */
-    passingScore: number;
-    /** Total possible points across all questions. */
-    totalPoints: number;
-    /** Whether partial credit is allowed on multi-select questions. Defaults to `false`. */
-    allowPartialCredit?: boolean;
-    /** Whether to penalize wrong answers (negative marking). Defaults to `false`. */
-    negativeMark?: boolean;
-    /** Maximum number of attempts allowed. `0` = unlimited. Defaults to `0`. */
-    maxAttempts?: number;
-    /** Time limit in seconds. `0` = no limit. Defaults to `0`. */
-    timeLimitSeconds?: number;
-    /** Whether to randomize question order when presenting. Defaults to `false`. */
-    shuffleQuestions?: boolean;
-}
+export type { WquizDocument, WquizQuestion, WquizQuestionType, WquizAnswer, WquizScoringRules } from '@soulcraft/formats/wquiz';
 //# sourceMappingURL=wquiz.d.ts.map

package/dist/modules/formats/wquiz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wquiz.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wquiz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAM1C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,OAAO,EAAE,KAAK,CAAA;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAA;AAE3F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,IAAI,EAAE,iBAAiB,CAAA;IACvB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,0FAA0F;IAC1F,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;IACrB,+EAA+E;IAC/E,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAA;IACV,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,wFAAwF;IACxF,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B"}
+{"version":3,"file":"wquiz.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wquiz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/modules/formats/wquiz.js

@@ -1,23 +1,11 @@
 /**
  * @module formats/wquiz
- * @description Type definitions for the WQUIZ (Workshop Quiz) document format.
+ * @description Re-exports WQUIZ types from `@soulcraft/formats`.
  *
  * WQUIZ documents are portable assessment and quiz definitions. They support
- * multiple-choice, true/false, short-answer, and essay question types, with
- * per-question point values, optional explanations, and configurable scoring.
- *
- * WQUIZ files are stored in the VFS with the `.wquiz.json` extension. Academy
- * uses them for module assessments; Workshop can render them for self-check quizzes.
- *
- * Question content supports rich formatting via WDOC blocks, enabling code
- * snippets, images, and callouts inside questions and answer choices.
- *
- * @example Reading a WQUIZ from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/assessments/module-1.wquiz.json')
- * const quiz: WquizDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(`${quiz.questions.length} questions, ${quiz.scoring.totalPoints} points`)
- * ```
+ * multiple-choice, true/false, short-answer, and essay question types with
+ * per-question point values and configurable scoring. Stored in the VFS with
+ * the `.wquiz.json` extension; used by Academy for module assessments.
  */
 export {};
 //# sourceMappingURL=wquiz.js.map

package/dist/modules/formats/wquiz.js.map

@@ -1 +1 @@
-{"version":3,"file":"wquiz.js","sourceRoot":"","sources":["../../../src/modules/formats/wquiz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"wquiz.js","sourceRoot":"","sources":["../../../src/modules/formats/wquiz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/modules/formats/wslide.d.ts

@@ -1,130 +1,10 @@
 /**
  * @module formats/wslide
- * @description Type definitions for the WSLIDE (Workshop Slide Deck) document format.
+ * @description Re-exports WSLIDE types from `@soulcraft/formats`.
  *
  * WSLIDE documents are portable slide presentations. Each slide contains rich
  * content blocks (in WDOC format), a layout preset, optional background, and
- * transition configuration.
- *
- * WSLIDE files are stored in the VFS with the `.wslide.json` extension and can
- * be rendered by any Soulcraft product that embeds the Workshop slideshow viewer.
- *
- * Content blocks within each slide reuse the WDOC block types — the same block
- * system that powers the Workshop document editor applies inside slides.
- *
- * @example Reading a WSLIDE document from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/presentations/onboarding.wslide.json')
- * const deck: WslideDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(`${deck.slides.length} slides`)
- * ```
- */
-import type { WdocBlock } from './wdoc.js';
-/**
- * Predefined layout preset for a slide.
- *
- * - `title` — Centered title + subtitle
- * - `content` — Title bar + full content area below
- * - `two-column` — Title bar + two equal-width content columns
- * - `image-left` — Image panel on the left, content on the right
- * - `image-right` — Content on the left, image panel on the right
- * - `image-full` — Full-bleed background image with overlaid text
- * - `blank` — No preset layout; positions are fully custom
- */
-export type WslideLayout = 'title' | 'content' | 'two-column' | 'image-left' | 'image-right' | 'image-full' | 'blank';
-/**
- * Slide-to-slide transition animation.
- *
- * - `none` — Instant cut
- * - `fade` — Cross-fade dissolve
- * - `slide` / `slide-left` — Slide the new content in from the right
- * - `slide-right` — Slide the new content in from the left
- * - `slide-up` / `slide-down` — Vertical slide
- * - `zoom` / `zoom-in` — Zoom in from center
- * - `zoom-out` — Zoom out to reveal next slide
- */
-export type WslideTransition = 'none' | 'fade' | 'slide' | 'slide-left' | 'slide-right' | 'slide-up' | 'slide-down' | 'zoom' | 'zoom-in' | 'zoom-out';
-/**
- * A WSLIDE presentation document.
- */
-export interface WslideDocument {
-    /** Format discriminator. Always `'wslide'`. */
-    format: 'wslide';
-    /** Schema version. Currently `'1.0'`. */
-    version: '1.0';
-    /** Presentation title. */
-    title?: string;
-    /** Author name or user ID. */
-    author?: string;
-    /** ISO 8601 creation timestamp. */
-    createdAt?: string;
-    /** ISO 8601 last-modified timestamp. */
-    updatedAt?: string;
-    /** Ordered list of slides. */
-    slides: WslideSlide[];
-    /** Presentation-level display settings. */
-    config?: WslideConfig;
-}
-/**
- * A single slide in a WSLIDE presentation.
- */
-export interface WslideSlide {
-    /** Unique slide identifier (stable across reorders). */
-    id: string;
-    /** Slide title shown in the navigation/outline panel. */
-    title: string;
-    /** Rich content blocks (WDOC format). */
-    content: WdocBlock[];
-    /** Speaker notes (plain text or Markdown). Not shown to the audience. */
-    notes?: string;
-    /** Background override for this slide (overrides the presentation default). */
-    background?: WslideBackground;
-    /** Layout preset for this slide. */
-    layout?: WslideLayout;
-    /** Transition to use when advancing TO this slide. */
-    transition?: WslideTransition;
-    /** Arbitrary per-slide metadata for product-specific use. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Slide background configuration.
- */
-export interface WslideBackground {
-    /** Background type. */
-    type: 'color' | 'gradient' | 'image';
-    /**
-     * Background value:
-     * - `color`: CSS hex or named color, e.g. `'#1a1a2e'`
-     * - `gradient`: CSS gradient string, e.g. `'linear-gradient(135deg, #1a1a2e, #16213e)'`
-     * - `image`: URL or VFS path to an image file
-     */
-    value: string;
-    /** Opacity for image backgrounds (0–1). Defaults to 1. */
-    opacity?: number;
-}
-/**
- * Presentation-level display configuration.
+ * transition configuration. Stored in the VFS with the `.wslide.json` extension.
  */
-export interface WslideConfig {
-    /** Auto-advance interval in seconds. `0` = manual navigation. Defaults to `0`. */
-    autoAdvance?: number;
-    /** Show slide numbers in the viewer. Defaults to `true`. */
-    showSlideNumbers?: boolean;
-    /** Show a progress bar across the bottom. Defaults to `true`. */
-    showProgress?: boolean;
-    /** Show previous/next navigation arrows. Defaults to `true`. */
-    showNavigation?: boolean;
-    /** Show the speaker notes panel. Defaults to `false`. */
-    showNotes?: boolean;
-    /** Enable keyboard navigation (arrow keys, space). Defaults to `true`. */
-    keyboardNavigation?: boolean;
-    /** Loop back to the first slide after the last. Defaults to `false`. */
-    loop?: boolean;
-    /** Default transition for all slides (overridden per-slide by `WslideSlide.transition`). */
-    defaultTransition?: WslideTransition;
-    /** Slide aspect ratio. Defaults to `'16:9'`. */
-    aspectRatio?: '16:9' | '4:3' | '16:10' | 'auto';
-    /** Color theme. Defaults to `'auto'` (follows system preference). */
-    theme?: 'dark' | 'light' | 'auto';
-}
+export type { WslideDocument, WslideSlide, WslideBackground, WslideLayout, WslideTransition, WslideConfig } from '@soulcraft/formats/wslide';
 //# sourceMappingURL=wslide.d.ts.map

package/dist/modules/formats/wslide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wslide.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wslide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAM1C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,OAAO,CAAA;AAEX;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,aAAa,GACb,UAAU,GACV,YAAY,GACZ,MAAM,GACN,SAAS,GACT,UAAU,CAAA;AAMd;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,MAAM,EAAE,QAAQ,CAAA;IAChB,yCAAyC;IACzC,OAAO,EAAE,KAAK,CAAA;IACd,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,sDAAsD;IACtD,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;IACpC;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,gBAAgB,CAAA;IACpC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;IAC/C,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;CAClC"}
+{"version":3,"file":"wslide.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wslide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/modules/formats/wslide.js

@@ -1,23 +1,10 @@
 /**
  * @module formats/wslide
- * @description Type definitions for the WSLIDE (Workshop Slide Deck) document format.
+ * @description Re-exports WSLIDE types from `@soulcraft/formats`.
  *
  * WSLIDE documents are portable slide presentations. Each slide contains rich
  * content blocks (in WDOC format), a layout preset, optional background, and
- * transition configuration.
- *
- * WSLIDE files are stored in the VFS with the `.wslide.json` extension and can
- * be rendered by any Soulcraft product that embeds the Workshop slideshow viewer.
- *
- * Content blocks within each slide reuse the WDOC block types — the same block
- * system that powers the Workshop document editor applies inside slides.
- *
- * @example Reading a WSLIDE document from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/presentations/onboarding.wslide.json')
- * const deck: WslideDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(`${deck.slides.length} slides`)
- * ```
+ * transition configuration. Stored in the VFS with the `.wslide.json` extension.
  */
 export {};
 //# sourceMappingURL=wslide.js.map

package/dist/modules/formats/wslide.js.map

@@ -1 +1 @@
-{"version":3,"file":"wslide.js","sourceRoot":"","sources":["../../../src/modules/formats/wslide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"wslide.js","sourceRoot":"","sources":["../../../src/modules/formats/wslide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/modules/formats/wviz.d.ts

@@ -1,114 +1,11 @@
 /**
  * @module formats/wviz
- * @description Type definitions for the WVIZ (Soulcraft Visualization) document format.
+ * @description Re-exports WVIZ types from `@soulcraft/formats`.
  *
  * WVIZ documents are portable, self-contained graph snapshots. They capture a
  * filtered view of a Brainy knowledge graph — entities and edges — along with
- * enough metadata to render them in any Soulcraft view (graph, mindmap, tree, etc.)
- * without requiring a live Brainy connection.
- *
- * WVIZ files are stored in the VFS with the `.wviz.json` extension and can be
- * exported from Workshop's Explore panel or generated programmatically.
- *
- * @example Reading a WVIZ document from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/visualizations/product-graph.wviz.json')
- * const viz: WvizDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(viz.entities.length) // number of nodes
- * ```
- */
-/**
- * The rendering mode to use when displaying a WVIZ document.
- *
- * - `graph` — Force-directed node-link diagram (default)
- * - `mindmap` — Radial tree rooted at a central concept
- * - `tree` — Hierarchical top-down tree layout
- * - `tapestry` — Narrative woven-thread visualization (Soulcraft-specific)
- * - `workflow` — Left-to-right directed flow
- * - `board` — Kanban-style column layout
- * - `list` — Flat list view with metadata columns
- * - `table` — Sortable tabular grid
- * - `gallery` — Card grid with thumbnails
- * - `calendar` — Date-based calendar view
- * - `timeline` — Chronological timeline
- */
-export type WvizViewType = 'graph' | 'mindmap' | 'tree' | 'tapestry' | 'workflow' | 'board' | 'list' | 'table' | 'gallery' | 'calendar' | 'timeline';
-/**
- * A self-contained visualization document.
- *
- * Entities and edges are snapshotted at export time. They are NOT live references
- * to a Brainy graph — rendering does not require a Brainy connection.
- */
-export interface WvizDocument {
-    /** Format discriminator. Always `'wviz'`. */
-    format: 'wviz';
-    /** Schema version. Currently `'1.0'`. */
-    version: '1.0';
-    /** Human-readable document title. */
-    title?: string;
-    /** Which view type to render this document with. */
-    viewType: WvizViewType;
-    /**
-     * View-specific configuration (layout algorithm, color scheme, label settings, etc.).
-     * Shape is view-type-specific and interpreted by the rendering component.
-     */
-    viewConfig: Record<string, unknown>;
-    /** Snapshotted entity list. These are not live Brainy entity references. */
-    entities: WvizEntity[];
-    /** Edges connecting entities. */
-    edges: WvizEdge[];
-    /**
-     * Saved node positions for force-directed layouts.
-     * Key is entity ID; value is `{ x, y }` in canvas coordinates.
-     * When present, the layout is pinned rather than recalculated on each render.
-     */
-    positions?: Record<string, {
-        x: number;
-        y: number;
-    }>;
-    /**
-     * Provenance metadata describing where this snapshot came from.
-     * Recorded at export time; not updated when entities change in Brainy.
-     */
-    snapshot?: WvizSnapshot;
-}
-/**
- * A single entity (node) in a WVIZ document.
- */
-export interface WvizEntity {
-    /** Unique identifier within this document (matches the Brainy entity ID at export time). */
-    id: string;
-    /** Brainy NounType string (e.g. `'concept'`, `'person'`, `'task'`). */
-    type: string;
-    /** Human-readable name shown as the node label. */
-    name: string;
-    /** Additional metadata fields captured at export time. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * A directed edge (relationship) between two entities in a WVIZ document.
- */
-export interface WvizEdge {
-    /** Source entity ID. Must match a `WvizEntity.id` in the same document. */
-    from: string;
-    /** Target entity ID. Must match a `WvizEntity.id` in the same document. */
-    to: string;
-    /** Brainy VerbType string describing the relationship (e.g. `'relatesTo'`, `'blocks'`). */
-    verb: string;
-}
-/**
- * Provenance metadata for a WVIZ snapshot.
+ * enough metadata to render them in any Soulcraft view without requiring a live
+ * Brainy connection. Stored in the VFS with the `.wviz.json` extension.
  */
-export interface WvizSnapshot {
-    /** ISO 8601 timestamp when this snapshot was taken. */
-    createdAt: string;
-    /** Workspace ID the entities were exported from. */
-    sourceWorkspace?: string;
-    /** Collection or workbench name at time of export. */
-    sourceWorkbench?: string;
-    /** Total entity count in the source (may differ from `entities.length` after filtering). */
-    entityCount: number;
-    /** Total edge count in the source. */
-    edgeCount: number;
-}
+export type { WvizDocument, WvizEntity, WvizEdge, WvizSnapshot, WvizViewType } from '@soulcraft/formats/wviz';
 //# sourceMappingURL=wviz.d.ts.map

package/dist/modules/formats/wviz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wviz.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wviz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,OAAO,GACP,MAAM,GACN,OAAO,GACP,SAAS,GACT,UAAU,GACV,UAAU,CAAA;AAMd;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,OAAO,EAAE,KAAK,CAAA;IACd,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,QAAQ,EAAE,YAAY,CAAA;IACtB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,4EAA4E;IAC5E,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,iCAAiC;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpD;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4FAA4F;IAC5F,EAAE,EAAE,MAAM,CAAA;IACV,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAA;IACV,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"wviz.d.ts","sourceRoot":"","sources":["../../../src/modules/formats/wviz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/modules/formats/wviz.js

@@ -1,21 +1,11 @@
 /**
  * @module formats/wviz
- * @description Type definitions for the WVIZ (Soulcraft Visualization) document format.
+ * @description Re-exports WVIZ types from `@soulcraft/formats`.
  *
  * WVIZ documents are portable, self-contained graph snapshots. They capture a
  * filtered view of a Brainy knowledge graph — entities and edges — along with
- * enough metadata to render them in any Soulcraft view (graph, mindmap, tree, etc.)
- * without requiring a live Brainy connection.
- *
- * WVIZ files are stored in the VFS with the `.wviz.json` extension and can be
- * exported from Workshop's Explore panel or generated programmatically.
- *
- * @example Reading a WVIZ document from the VFS
- * ```typescript
- * const buf = await sdk.vfs.readFile('/visualizations/product-graph.wviz.json')
- * const viz: WvizDocument = JSON.parse(buf.toString('utf-8'))
- * console.log(viz.entities.length) // number of nodes
- * ```
+ * enough metadata to render them in any Soulcraft view without requiring a live
+ * Brainy connection. Stored in the VFS with the `.wviz.json` extension.
  */
 export {};
 //# sourceMappingURL=wviz.js.map

package/dist/modules/formats/wviz.js.map

@@ -1 +1 @@
-{"version":3,"file":"wviz.js","sourceRoot":"","sources":["../../../src/modules/formats/wviz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"wviz.js","sourceRoot":"","sources":["../../../src/modules/formats/wviz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/version.d.ts

@@ -7,5 +7,5 @@
  * in one place ensures it is always in sync with `package.json`.
  */
 /** The current @soulcraft/sdk package version. */
-export declare const SDK_VERSION = "1.4.6";
+export declare const SDK_VERSION = "1.4.9";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -7,5 +7,5 @@
  * in one place ensures it is always in sync with `package.json`.
  */
 /** The current @soulcraft/sdk package version. */
-export const SDK_VERSION = '1.4.6';
+export const SDK_VERSION = '1.4.9';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/sdk",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "description": "The unified Soulcraft platform SDK — data, auth, AI, billing, and notifications",
   "type": "module",
   "publishConfig": {
@@ -56,6 +56,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "@msgpack/msgpack": "^3.0.0",
+    "@soulcraft/formats": "1.0.1",
     "better-auth": "^1.0.0",
     "lru-cache": "^11.0.0",
     "stripe": "^20.4.0"