@kaskad/core 0.0.6 → 0.0.8

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@kaskad/core",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "peerDependencies": {
-    "@kaskad/types": "0.0.6",
-    "@kaskad/config": "0.0.6",
-    "@kaskad/definition": "0.0.6",
-    "@kaskad/schema": "0.0.6",
-    "@kaskad/component-tree": "0.0.6",
-    "@kaskad/formula-parser": "0.0.6",
-    "@kaskad/eval-tree": "0.0.6",
+    "@kaskad/types": "0.0.8",
+    "@kaskad/config": "0.0.8",
+    "@kaskad/definition": "0.0.8",
+    "@kaskad/schema": "0.0.8",
+    "@kaskad/component-tree": "0.0.8",
+    "@kaskad/formula-parser": "0.0.8",
+    "@kaskad/eval-tree": "0.0.8",
     "mobx": "^6.13.7",
     "rxjs": "~7.8.0",
     "yaml": "^2.0.0"
@@ -23,6 +23,10 @@
     ".": {
       "types": "./types/kaskad-core.d.ts",
       "default": "./fesm2022/kaskad-core.mjs"
+    },
+    "./testing": {
+      "types": "./types/kaskad-core-testing.d.ts",
+      "default": "./fesm2022/kaskad-core-testing.mjs"
     }
   },
   "dependencies": {

package/types/kaskad-core-testing.d.ts

@@ -0,0 +1,34 @@
+import { ComponentRecipe, TComponent, ComponentId } from '@kaskad/core';
+
+declare function createView(rawSchema: ComponentRecipe): Promise<void>;
+declare function loadYamlSchema(absolutePath: string): ComponentRecipe;
+declare function loadYamlSchemaFrom(baseDir: string, relativePath: string): ComponentRecipe;
+declare function createViewFromFile(baseDir: string, relativePath: string): Promise<void>;
+/**
+ * Sets up a fetch mock that resolves `/recipes/{path}.yml` URLs to actual files.
+ * Use this when testing recipes that use `templateUrl` to load external templates.
+ *
+ * @param recipesBaseDir - The base directory where recipe files are located
+ *
+ * @example
+ * ```typescript
+ * // In your test file
+ * import { setupRecipeFetch } from '@kaskad/core/testing';
+ * import * as path from 'node:path';
+ *
+ * setupRecipeFetch(path.resolve(__dirname, '../..'));
+ * ```
+ */
+declare function setupRecipeFetch(recipesBaseDir: string): void;
+declare function setCurrent(selector: string): void;
+declare function get<T = unknown>(selector: string): T;
+declare function set<T = unknown>(selector: string, value: T): void;
+declare function run(selector: string, ...args: unknown[]): Promise<unknown>;
+declare function select(selector: string): TComponent;
+declare function selectAll(selector: string): TComponent[];
+declare function evaluating(selector: string): boolean;
+declare function running(selector: string): boolean;
+declare function getComponentType(selector: string): string;
+declare function getId(selector: string): ComponentId;
+
+export { createView, createViewFromFile, evaluating, get, getComponentType, getId, loadYamlSchema, loadYamlSchemaFrom, run, running, select, selectAll, set, setCurrent, setupRecipeFetch };

package/types/kaskad-core.d.ts

@@ -1,8 +1,11 @@
 import { ValueType, NodePosition } from '@kaskad/types';
 export * from '@kaskad/types';
+import { CommandDefinition } from '@kaskad/definition';
 export * from '@kaskad/definition';
+import { ComponentRawDefinition } from '@kaskad/schema';
 export { ComponentRawDefinition, ComponentRecipe, loadTemplates, templateRegistry, unfoldComponentDefinitions, unfoldNodeSchema } from '@kaskad/schema';
-export { FunctionRegistry, ImperativeFunctionDefinition } from '@kaskad/eval-tree';
+import { FunctionDefinition } from '@kaskad/eval-tree';
+export { FunctionDefinition, FunctionRegistry, ImperativeFunctionDefinition } from '@kaskad/eval-tree';
 import { AbstractNode, CommandNode } from '@kaskad/component-tree';
 export { CommandRef, ComponentStore, ComponentTreeApi, TComponent, createRootNode } from '@kaskad/component-tree';
 
@@ -16,7 +19,17 @@ declare class TemplateLoadingTracker {
 }
 declare const templateLoadingTracker: TemplateLoadingTracker;
 
-declare function registerCommonDefinitions(): void;
+interface KaskadPlugin {
+    definitions?: Record<string, ComponentRawDefinition>;
+    shapes?: Record<string, Record<string, ValueType>>;
+    functions?: Record<string, FunctionDefinition>;
+    commands?: Record<string, CommandDefinition>;
+    setup?: () => void;
+}
+declare function registerPlugin(plugin: KaskadPlugin): void;
+declare function registerPlugins(...plugins: KaskadPlugin[]): void;
+
+declare const common: KaskadPlugin;
 
 declare function activateNode(node: AbstractNode<ValueType>): void;
 
@@ -27,9 +40,9 @@ declare function runCommand(node: CommandNode, ...args: unknown[]): Promise<unkn
 declare const debugName: (position: NodePosition, thing: string) => string;
 declare const componentInstanceMap: Map<string, unknown>;
 
-declare function autoRegisterCommonDefinitions(): void;
+declare const sys: KaskadPlugin;
 
-declare function autoRegisterBrowserDefinitions(): void;
+declare const browser: KaskadPlugin;
 
 interface ValidatorDefinition<TParams = any> {
     params: Record<string, ValueType>;
@@ -56,9 +69,9 @@ interface ValidatorProperty {
 
 declare function registerValidator(validatorType: string, def: ValidatorDefinition): void;
 declare function registerValidators(validators: Record<string, ValidatorDefinition>): void;
-declare function autoRegisterFormsDefinitions(): void;
+declare const forms: KaskadPlugin;
 
 declare function initRuntime(): void;
 
-export { activateNode, activateStructure, autoRegisterBrowserDefinitions, autoRegisterCommonDefinitions, autoRegisterFormsDefinitions, componentInstanceMap, debugName, initRuntime, registerCommonDefinitions, registerValidator, registerValidators, runCommand, templateLoadingTracker };
-export type { Validate, ValidationResult, ValidatorDefinition, ValidatorProperty, ValidatorRawValue };
+export { activateNode, activateStructure, browser, common, componentInstanceMap, debugName, forms, initRuntime, registerPlugin, registerPlugins, registerValidator, registerValidators, runCommand, sys, templateLoadingTracker };
+export type { KaskadPlugin, Validate, ValidationResult, ValidatorDefinition, ValidatorProperty, ValidatorRawValue };