@stonecrop/stonecrop 0.10.12 → 0.10.13

package/dist/src/stonecrop.d.ts

@@ -1,29 +1,23 @@
+import { type SchemaTypes } from '@stonecrop/aform';
 import type { DataClient } from '@stonecrop/schema';
 import Doctype from './doctype';
 import Registry from './registry';
 import { type HSTNode } from './stores/hst';
 import type { OperationLogConfig } from './types/operation-log';
 import type { RouteContext } from './types/registry';
-/**
- * Options for constructing a Stonecrop instance directly.
- * When using the Vue plugin, pass these via `InstallOptions` instead.
- * @public
- */
-export interface StonecropOptions {
-    /**
-     * Data client for fetching doctype metadata and records.
-     * Use \@stonecrop/graphql-client's StonecropClient for GraphQL backends,
-     * or implement DataClient for custom data sources.
-     *
-     * Can be set later via `setClient()` for deferred configuration.
-     */
-    client?: DataClient;
-}
+import type { StonecropOptions } from './types/stonecrop';
 /**
  * Main Stonecrop class with HST integration and built-in Operation Log
  * @public
  */
 export declare class Stonecrop {
+    /**
+     * Singleton instance of Stonecrop. Only one Stonecrop instance can exist
+     * per application, ensuring consistent HST state and registry access.
+     * Subsequent constructor calls return this instance instead of creating new ones.
+     * @internal
+     */
+    static _root: Stonecrop;
     private hstStore;
     private _operationLogStore?;
     private _operationLogConfig?;
@@ -31,7 +25,7 @@ export declare class Stonecrop {
     /** The registry instance containing all doctype definitions */
     readonly registry: Registry;
     /**
-     * Creates a new Stonecrop instance with HST integration
+     * Creates a new Stonecrop instance with HST integration (singleton pattern)
      * @param registry - The Registry instance containing doctype definitions
      * @param operationLogConfig - Optional configuration for the operation log
      * @param options - Options including the data client (can be set later via setClient)
@@ -146,7 +140,7 @@ export declare class Stonecrop {
         getSnapshot: () => import("./types").OperationLogSnapshot;
         markIrreversible: (operationId: string, reason: string) => void;
         logAction: (doctype: string, actionName: string, recordIds?: string[], result?: "success" | "failure" | "pending", error?: string) => string;
-    }, "operations" | "currentIndex" | "config" | "clientId">, Pick<{
+    }, "operations" | "clientId" | "currentIndex" | "config">, Pick<{
         operations: import("vue").Ref<{
             id: string;
             type: import("./types").HSTOperationType;
@@ -435,5 +429,32 @@ export declare class Stonecrop {
      * @public
      */
     getRecordState(doctype: string | Doctype, recordId: string): string;
+    /**
+     * Collect a record payload with all nested doctype fields from HST
+     * @param doctype - The doctype metadata
+     * @param recordId - The record ID to collect
+     * @returns The complete record payload ready for API submission
+     * @public
+     */
+    collectRecordPayload(doctype: Doctype, recordId: string): Record<string, any>;
+    /**
+     * Load nested data from HST or initialize with defaults
+     * @param parentPath - The HST path to check for existing data
+     * @param childDoctype - The child doctype metadata
+     * @param _recordId - Optional record ID to load
+     * @returns The loaded or initialized data
+     * @public
+     */
+    loadNestedData(parentPath: string, childDoctype: Doctype, _recordId?: string): Record<string, any>;
 }
+/**
+ * Recursively collect nested data from HST using pre-resolved schemas
+ * @param resolvedSchema - The already-resolved schema (with nested schemas embedded)
+ * @param basePath - The base path in HST (e.g., "customer.123.address")
+ * @param hstStore - The HST store instance
+ * @returns The collected data object
+ * @public
+ */
+declare function collectNestedData(resolvedSchema: SchemaTypes[], basePath: string, hstStore: HSTNode): Record<string, any>;
+export { collectNestedData };
 //# sourceMappingURL=stonecrop.d.ts.map

package/dist/src/stonecrop.d.ts.map

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

package/dist/src/stores/operation-log.d.ts

@@ -92,7 +92,7 @@ export declare const useOperationLogStore: import("pinia").StoreDefinition<"hst-
     getSnapshot: () => OperationLogSnapshot;
     markIrreversible: (operationId: string, reason: string) => void;
     logAction: (doctype: string, actionName: string, recordIds?: string[], result?: "success" | "failure" | "pending", error?: string) => string;
-}, "operations" | "currentIndex" | "config" | "clientId">, Pick<{
+}, "operations" | "clientId" | "currentIndex" | "config">, Pick<{
     operations: import("vue").Ref<{
         id: string;
         type: import("..").HSTOperationType;

package/dist/src/types/composable.d.ts

@@ -0,0 +1,230 @@
+import { SchemaTypes } from '@stonecrop/aform';
+import type { Ref, ComputedRef } from 'vue';
+import type Doctype from '../doctype';
+import type { HSTNode } from '../stores/hst';
+import type { HSTOperation, OperationLogConfig, OperationLogSnapshot } from './operation-log';
+/**
+ * Operation Log API - nested object containing all operation log functionality
+ * @public
+ */
+export type OperationLogAPI = {
+    /**
+     * List of all recorded operations in the log.
+     * Each operation represents a state change that can be undone/redone.
+     */
+    operations: Ref<HSTOperation[]>;
+    /**
+     * Current position in the operation log.
+     * -1 means no operations, 0 means at first operation, etc.
+     */
+    currentIndex: Ref<number>;
+    /**
+     * Computed snapshot of undo/redo state.
+     * Use this for UI indicators (buttons, menu state).
+     */
+    undoRedoState: ComputedRef<{
+        canUndo: boolean;
+        canRedo: boolean;
+        undoCount: number;
+        redoCount: number;
+        currentIndex: number;
+    }>;
+    /**
+     * Whether undo is currently available.
+     * True when there are operations that can be undone.
+     */
+    canUndo: ComputedRef<boolean>;
+    /**
+     * Whether redo is currently available.
+     * True when there are undone operations that can be redone.
+     */
+    canRedo: ComputedRef<boolean>;
+    /**
+     * Number of operations available to undo.
+     */
+    undoCount: ComputedRef<number>;
+    /**
+     * Number of operations available to redo.
+     */
+    redoCount: ComputedRef<number>;
+    /**
+     * Undo the last operation.
+     * @param hstStore - The HST node to apply the inverse operation to
+     * @returns True if undo succeeded, false if nothing to undo
+     */
+    undo: (hstStore: HSTNode) => boolean;
+    /**
+     * Redo the last undone operation.
+     * @param hstStore - The HST node to apply the operation to
+     * @returns True if redo succeeded, false if nothing to redo
+     */
+    redo: (hstStore: HSTNode) => boolean;
+    /**
+     * Start batching multiple operations together.
+     * Call before a series of changes that should be undone/redone as a unit.
+     */
+    startBatch: () => void;
+    /**
+     * Commit the current batch of operations.
+     * @param description - Optional description for the batch
+     * @returns The batch operation ID, or null if no batch in progress
+     */
+    commitBatch: (description?: string) => string | null;
+    /**
+     * Cancel the current batch without committing.
+     * Discards all operations added since startBatch().
+     */
+    cancelBatch: () => void;
+    /**
+     * Clear all operations from the log.
+     * Resets the log to its initial empty state.
+     */
+    clear: () => void;
+    /**
+     * Get all operations for a specific doctype.
+     * @param doctype - The doctype name to filter by
+     * @param recordId - Optional record ID to further filter
+     * @returns Array of matching operations
+     */
+    getOperationsFor: (doctype: string, recordId?: string) => HSTOperation[];
+    /**
+     * Get a serializable snapshot of the operation log.
+     * Use for debugging, logging, or state persistence.
+     * @returns Snapshot containing operations and current index
+     */
+    getSnapshot: () => OperationLogSnapshot;
+    /**
+     * Mark an operation as irreversible.
+     * Irreversible operations cannot be undone.
+     * @param operationId - The operation ID to mark
+     * @param reason - Human-readable reason why it cannot be undone
+     */
+    markIrreversible: (operationId: string, reason: string) => void;
+    /**
+     * Log a custom action (non-HST operation).
+     * Use for tracking server calls, external side effects, etc.
+     * @param doctype - The doctype this action relates to
+     * @param actionName - Name of the action (e.g., 'save', 'submit')
+     * @param recordIds - Optional array of affected record IDs
+     * @param result - Optional result status
+     * @param error - Optional error message if result is 'failure'
+     * @returns The logged operation ID
+     */
+    logAction: (doctype: string, actionName: string, recordIds?: string[], result?: 'success' | 'failure' | 'pending', error?: string) => string;
+    /**
+     * Configure operation log options.
+     * @param options - Partial configuration to merge with existing settings
+     */
+    configure: (options: Partial<OperationLogConfig>) => void;
+};
+/**
+ * Base Stonecrop composable return type - includes operation log functionality
+ * @public
+ */
+export type BaseStonecropReturn = {
+    /**
+     * Reactive reference to the Stonecrop singleton instance.
+     * Use this to access class methods like `getRecord()`, `addRecord()`, `runAction()`.
+     */
+    stonecrop: Ref<Stonecrop | undefined>;
+    /**
+     * Operation log API for undo/redo functionality.
+     * Use `operationLog.undo()` and `operationLog.redo()` for user-triggered operations.
+     * Use `operationLog.startBatch()` / `operationLog.commitBatch()` for grouping operations.
+     */
+    operationLog: OperationLogAPI;
+};
+/**
+ * HST-enabled Stonecrop composable return type
+ * @public
+ */
+export type HSTStonecropReturn = BaseStonecropReturn & {
+    /**
+     * Generates a fully-qualified HST path for a field.
+     * Use this in nested components to create paths like "customer.123.address".
+     * @param fieldname - The field name to append to the path
+     * @param recordId - Optional record ID (defaults to current record)
+     * @returns The full HST path string
+     */
+    provideHSTPath: (fieldname: string, recordId?: string) => string;
+    /**
+     * Handles a field value change and updates HST.
+     * Call this from form input handlers to persist changes to the store.
+     * @param changeData - Object containing path, value, fieldname, and optional recordId
+     */
+    handleHSTChange: (changeData: HSTChangeData) => void;
+    /**
+     * Reactive reference to the HST node for this doctype/record.
+     * Use this to read current form state or subscribe to changes.
+     */
+    hstStore: Ref<HSTNode | undefined>;
+    /**
+     * Reactive form data bound to HST.
+     * Use this as the v-model target for form inputs. Changes sync to hstStore.
+     */
+    formData: Ref<Record<string, any>>;
+    /**
+     * Resolved schema with nested Doctype fields expanded.
+     * Use this to iterate over fields for rendering, excluding nested doctypes handled separately.
+     */
+    resolvedSchema: Ref<SchemaTypes[]>;
+    /**
+     * Loads or initializes nested doctype data.
+     * Use this when rendering a nested form component. Checks HST first, then initializes defaults.
+     * @param parentPath - The HST path to check for existing data
+     * @param childDoctype - The nested doctype metadata
+     * @param recordId - Optional record ID (reserved for future API fetch)
+     * @returns The loaded or initialized data object
+     */
+    loadNestedData: (parentPath: string, childDoctype: Doctype, recordId?: string) => Record<string, any>;
+    /**
+     * Collects a complete record payload with all nested data from HST.
+     * Use this before submitting to an API. Recursively includes 1:1 and 1:many nested records.
+     * @param doctype - The doctype metadata
+     * @param recordId - The record ID to collect
+     * @returns The complete record payload ready for API submission
+     */
+    collectRecordPayload: (doctype: Doctype, recordId: string) => Record<string, any>;
+    /**
+     * Creates a nested context for a child doctype component.
+     * Use this in parent components to pass scoped handlers to child components.
+     * @param basePath - The parent HST path prefix
+     * @param childDoctype - The child doctype metadata
+     * @returns Scoped provideHSTPath and handleHSTChange functions
+     */
+    createNestedContext: (basePath: string, childDoctype: Doctype) => {
+        provideHSTPath: (fieldname: string) => string;
+        handleHSTChange: (changeData: HSTChangeData) => void;
+    };
+    /**
+     * Loading state for async doctype resolution.
+     * True while fetching doctype by slug string from registry.
+     */
+    isLoading: Ref<boolean>;
+    /**
+     * Error state for doctype resolution failures.
+     * Set when doctype slug lookup fails.
+     */
+    error: Ref<Error | null>;
+    /**
+     * Resolved doctype instance.
+     * Available immediately if Doctype instance passed, after async resolution if slug string passed.
+     */
+    resolvedDoctype: Ref<Doctype | undefined>;
+};
+import type { Stonecrop } from '../stonecrop';
+/**
+ * HST Change data structure
+ * @public
+ */
+export type HSTChangeData = {
+    /** Full HST path to the changed field */
+    path: string;
+    /** New value for the field */
+    value: any;
+    /** Field name that changed */
+    fieldname: string;
+    /** Optional record ID */
+    recordId?: string;
+};
+//# sourceMappingURL=composable.d.ts.map

package/dist/src/types/composable.d.ts.map

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

package/dist/src/types/doctype.d.ts

@@ -0,0 +1,57 @@
+import type { SchemaTypes } from '@stonecrop/aform';
+import type { WorkflowMeta } from '@stonecrop/schema';
+import { List, Map } from 'immutable';
+import type { AnyStateNodeConfig, UnknownMachineConfig } from 'xstate';
+/**
+ * Immutable Doctype type for Stonecrop instances
+ * @public
+ */
+export type ImmutableDoctype = {
+    readonly schema?: List<SchemaTypes>;
+    readonly workflow?: UnknownMachineConfig | AnyStateNodeConfig | WorkflowMeta;
+    readonly actions?: Map<string, string[]>;
+};
+/**
+ * Mutable Doctype type for Stonecrop instances
+ * @public
+ */
+export type MutableDoctype = {
+    doctype?: string;
+    schema?: SchemaTypes[];
+    workflow?: UnknownMachineConfig | AnyStateNodeConfig | WorkflowMeta;
+    actions?: Record<string, string[]>;
+};
+/**
+ * Schema type for Stonecrop instances
+ * @public
+ */
+export type Schema = {
+    doctype: string;
+    schema: List<SchemaTypes>;
+};
+/**
+ * Plain object representation of doctype configuration for serialization/API responses.
+ * Compatible with the DoctypeMeta type from \@stonecrop/schema.
+ * @public
+ */
+export type DoctypeConfig = {
+    /** Display name of the doctype */
+    name: string;
+    /** URL-friendly slug (kebab-case) */
+    slug?: string;
+    /** Database table name */
+    tableName?: string;
+    /** Field definitions */
+    fields?: SchemaTypes[];
+    /** Workflow configuration (XState format or simple WorkflowMeta) */
+    workflow?: UnknownMachineConfig | WorkflowMeta;
+    /** Actions and their field triggers */
+    actions?: Record<string, string[]>;
+    /** Parent doctype for inheritance */
+    inherits?: string;
+    /** Doctype to use for list views */
+    listDoctype?: string;
+    /** Parent doctype for child tables */
+    parentDoctype?: string;
+};
+//# sourceMappingURL=doctype.d.ts.map

package/dist/src/types/doctype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctype.d.ts","sourceRoot":"","sources":["../../../src/types/doctype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAEtE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,CAAA;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,CAAA;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAAA;IAC9C,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAClC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA"}

package/dist/src/types/index.d.ts

@@ -1,70 +1,9 @@
-import type { DataClient, WorkflowMeta } from '@stonecrop/schema';
-import type { SchemaTypes } from '@stonecrop/aform';
-import { List, Map } from 'immutable';
-import type { Component } from 'vue';
-import type { Router } from 'vue-router';
-import type { AnyStateNodeConfig, UnknownMachineConfig } from 'xstate';
-import type Doctype from '../doctype';
-import Registry from '../registry';
-import { Stonecrop } from '../stonecrop';
-import type { RouteContext } from './registry';
-/**
- * Immutable Doctype type for Stonecrop instances
- * @public
- */
-export type ImmutableDoctype = {
-    readonly schema?: List<SchemaTypes>;
-    readonly workflow?: UnknownMachineConfig | AnyStateNodeConfig | WorkflowMeta;
-    readonly actions?: Map<string, string[]>;
-};
-/**
- * Mutable Doctype type for Stonecrop instances
- * @public
- */
-export type MutableDoctype = {
-    doctype?: string;
-    schema?: SchemaTypes[];
-    workflow?: UnknownMachineConfig | AnyStateNodeConfig | WorkflowMeta;
-    actions?: Record<string, string[]>;
-};
-/**
- * Schema type for Stonecrop instances
- * @public
- */
-export type Schema = {
-    doctype: string;
-    schema: List<SchemaTypes>;
-};
-/**
- * Install options for Stonecrop Vue plugin
- * @public
- */
-export type InstallOptions = {
-    router?: Router;
-    components?: Record<string, Component>;
-    getMeta?: (routeContext: RouteContext) => Doctype | Promise<Doctype>;
-    /**
-     * Data client for fetching doctype metadata and records.
-     * Use \@stonecrop/graphql-client's StonecropClient for GraphQL backends,
-     * or implement DataClient for custom data sources.
-     *
-     * Can be set later via `useStonecropRegistry().setClient()` for deferred configuration.
-     *
-     * @example
-     * ```ts
-     * import { StonecropClient } from '@stonecrop/graphql-client'
-     *
-     * const client = new StonecropClient({ endpoint: '/graphql' })
-     * app.use(StonecropPlugin, { client })
-     * ```
-     */
-    client?: DataClient;
-    /** Automatically run initialization callback after app mounting (default: false) */
-    autoInitializeRouter?: boolean;
-    /** Callback function called after plugin is ready and mounted */
-    onRouterInitialized?: (registry: Registry, stonecrop: Stonecrop) => void | Promise<void>;
-};
+export * from './composable';
+export * from './doctype';
 export * from './field-triggers';
-export * from './registry';
 export * from './operation-log';
+export * from './plugin';
+export * from './registry';
+export * from './schema-validator';
+export * from './stonecrop';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAEtE,OAAO,KAAK,OAAO,MAAM,YAAY,CAAA;AACrC,OAAO,QAAQ,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,CAAA;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,CAAA;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxF,CAAA;AAGD,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA"}

package/dist/src/types/plugin.d.ts

@@ -0,0 +1,37 @@
+import type { DataClient } from '@stonecrop/schema';
+import type { Component } from 'vue';
+import type { Router } from 'vue-router';
+import type Doctype from '../doctype';
+import type Registry from '../registry';
+import type { Stonecrop } from '../stonecrop';
+import type { RouteContext } from './registry';
+/**
+ * Install options for Stonecrop Vue plugin
+ * @public
+ */
+export type InstallOptions = {
+    router?: Router;
+    components?: Record<string, Component>;
+    getMeta?: (routeContext: RouteContext) => Doctype | Promise<Doctype>;
+    /**
+     * Data client for fetching doctype metadata and records.
+     * Use \@stonecrop/graphql-client's StonecropClient for GraphQL backends,
+     * or implement DataClient for custom data sources.
+     *
+     * Can be set later via `useStonecropRegistry().setClient()` for deferred configuration.
+     *
+     * @example
+     * ```ts
+     * import { StonecropClient } from '@stonecrop/graphql-client'
+     *
+     * const client = new StonecropClient({ endpoint: '/graphql' })
+     * app.use(StonecropPlugin, { client })
+     * ```
+     */
+    client?: DataClient;
+    /** Automatically run initialization callback after app mounting (default: false) */
+    autoInitializeRouter?: boolean;
+    /** Callback function called after plugin is ready and mounted */
+    onRouterInitialized?: (registry: Registry, stonecrop: Stonecrop) => void | Promise<void>;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,KAAK,OAAO,MAAM,YAAY,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxF,CAAA"}

package/dist/src/types/schema-validator.d.ts

@@ -0,0 +1,64 @@
+import type Registry from '../registry';
+/**
+ * Validation severity levels
+ * @public
+ */
+export declare enum ValidationSeverity {
+    /** Blocking error that prevents save */
+    ERROR = "error",
+    /** Advisory warning that allows save */
+    WARNING = "warning",
+    /** Informational message */
+    INFO = "info"
+}
+/**
+ * Validation issue
+ * @public
+ */
+export interface ValidationIssue {
+    /** Severity level */
+    severity: ValidationSeverity;
+    /** Validation rule that failed */
+    rule: string;
+    /** Human-readable message */
+    message: string;
+    /** Doctype name */
+    doctype?: string;
+    /** Field name if applicable */
+    fieldname?: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+/**
+ * Validation result
+ * @public
+ */
+export interface ValidationResult {
+    /** Whether validation passed (no blocking errors) */
+    valid: boolean;
+    /** List of validation issues */
+    issues: ValidationIssue[];
+    /** Count of errors */
+    errorCount: number;
+    /** Count of warnings */
+    warningCount: number;
+    /** Count of info messages */
+    infoCount: number;
+}
+/**
+ * Schema validator options
+ * @public
+ */
+export interface ValidatorOptions {
+    /** Registry instance for doctype lookups */
+    registry?: Registry;
+    /** Whether to validate Link field targets */
+    validateLinkTargets?: boolean;
+    /** Whether to validate workflow reachability */
+    validateWorkflows?: boolean;
+    /** Whether to validate action registration */
+    validateActions?: boolean;
+    /** Whether to validate required schema properties */
+    validateRequiredProperties?: boolean;
+}
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/src/types/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../src/types/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AAEvC;;;GAGG;AACH,oBAAY,kBAAkB;IAC7B,wCAAwC;IACxC,KAAK,UAAU;IACf,wCAAwC;IACxC,OAAO,YAAY;IACnB,4BAA4B;IAC5B,IAAI,SAAS;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,qBAAqB;IACrB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAA;IACd,gCAAgC;IAChC,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,qDAAqD;IACrD,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACpC"}

package/dist/src/types/stonecrop.d.ts

@@ -0,0 +1,17 @@
+import type { DataClient } from '@stonecrop/schema';
+/**
+ * Options for constructing a Stonecrop instance directly.
+ * When using the Vue plugin, pass these via `InstallOptions` instead.
+ * @public
+ */
+export interface StonecropOptions {
+    /**
+     * Data client for fetching doctype metadata and records.
+     * Use \@stonecrop/graphql-client's StonecropClient for GraphQL backends,
+     * or implement DataClient for custom data sources.
+     *
+     * Can be set later via `setClient()` for deferred configuration.
+     */
+    client?: DataClient;
+}
+//# sourceMappingURL=stonecrop.d.ts.map

package/dist/src/types/stonecrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stonecrop.d.ts","sourceRoot":"","sources":["../../../src/types/stonecrop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;CACnB"}