@arkcit/engine 0.3.0

package/dist/studioProps.d.ts

@@ -0,0 +1,8 @@
+type UnknownRecord = Record<string, unknown>;
+declare const RENDER_BINDING_PROP_NAMES: Set<string>;
+declare const STUDIO_INTERNAL_PROP_NAMES: Set<string>;
+declare const getRenderBindingProps: (props: unknown) => UnknownRecord;
+declare const getStudioProps: (props: unknown) => UnknownRecord;
+declare const omitStudioProps: (props: UnknownRecord) => UnknownRecord;
+
+export { RENDER_BINDING_PROP_NAMES, STUDIO_INTERNAL_PROP_NAMES, getRenderBindingProps, getStudioProps, omitStudioProps };

package/dist/studioProps.js

@@ -0,0 +1,97 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/render-layer/renderDirectives.ts
+var RENDER_BINDING_PROP_NAMES = /* @__PURE__ */ new Set([
+  "bindingEnabled",
+  "valueBindingKey",
+  "optionsBindingKey",
+  "useBindingData",
+  "entitiesBindingKey",
+  "videoBindingKey",
+  "mapBindingKey",
+  "productBindingKey",
+  "useTranslationKeys",
+  "tagContentTranslationKey",
+  "tagContentTranslationValue",
+  "hrefTranslationKey",
+  "hrefTranslationValue",
+  "mediaSource",
+  "mediaSrc",
+  "mediaAlt",
+  "rowsBindingKey",
+  "columnsBindingKey"
+]);
+var STUDIO_INTERNAL_PROP_NAMES = /* @__PURE__ */ new Set([
+  ...RENDER_BINDING_PROP_NAMES
+]);
+var getRenderBindingProps = (props) => {
+  if (!props || typeof props !== "object" || Array.isArray(props)) {
+    return {};
+  }
+  const source = props;
+  const embedded = source.__studio && typeof source.__studio === "object" && !Array.isArray(source.__studio) ? source.__studio : {};
+  const legacy = Array.from(RENDER_BINDING_PROP_NAMES).reduce(
+    (accumulator, key) => {
+      if (source[key] !== void 0) {
+        accumulator[key] = source[key];
+      }
+      return accumulator;
+    },
+    {}
+  );
+  return Array.from(RENDER_BINDING_PROP_NAMES).reduce((accumulator, key) => {
+    if (legacy[key] !== void 0) {
+      accumulator[key] = legacy[key];
+    } else if (embedded[key] !== void 0) {
+      accumulator[key] = embedded[key];
+    }
+    return accumulator;
+  }, {});
+};
+var getStudioProps = (props) => {
+  if (!props || typeof props !== "object" || Array.isArray(props)) {
+    return {};
+  }
+  const source = props;
+  const embedded = source.__studio && typeof source.__studio === "object" && !Array.isArray(source.__studio) ? source.__studio : {};
+  const legacy = Array.from(STUDIO_INTERNAL_PROP_NAMES).reduce(
+    (accumulator, key) => {
+      if (source[key] !== void 0) {
+        accumulator[key] = source[key];
+      }
+      return accumulator;
+    },
+    {}
+  );
+  return __spreadValues(__spreadValues({}, legacy), embedded);
+};
+var omitStudioProps = (props) => {
+  const next = __spreadValues({}, props);
+  delete next.__studio;
+  for (const propName of STUDIO_INTERNAL_PROP_NAMES) {
+    delete next[propName];
+  }
+  return next;
+};
+export {
+  RENDER_BINDING_PROP_NAMES,
+  STUDIO_INTERNAL_PROP_NAMES,
+  getRenderBindingProps,
+  getStudioProps,
+  omitStudioProps
+};

package/dist/types-9TZ2lQDP.d.ts

@@ -0,0 +1,60 @@
+interface FieldOption {
+    value: string | number;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+type DeclarativeValidatorType = "required" | "minLength" | "maxLength" | "email" | "pattern";
+type DeclarativeValidatorConfig = {
+    id: string;
+    type: DeclarativeValidatorType;
+    enabled?: boolean;
+    params?: Record<string, unknown>;
+    message?: string;
+    messageKey?: string;
+    stopOnFailure?: boolean;
+};
+interface FieldConfig {
+    name: string;
+    label: string;
+    labelKey?: string;
+    placeholder?: string;
+    placeholderKey?: string;
+    pattern?: string;
+    validators?: DeclarativeValidatorConfig[];
+    type?: string;
+    options?: FieldOption[];
+    orientation?: "vertical" | "horizontal";
+    multiple?: boolean;
+    min?: number;
+    max?: number;
+    step?: number;
+    accept?: string;
+    maxFiles?: number;
+    maxSizeBytes?: number;
+    required?: boolean;
+}
+type Field = string | number | boolean | null | undefined | string[] | File[];
+type FormValues = Record<string, unknown>;
+type FormErrors = Record<string, string | undefined>;
+type FormTouched = Record<string, boolean | undefined>;
+type ValidationIssue = {
+    field: string;
+    validatorId?: string;
+    code?: string;
+    message?: string;
+    messageKey?: string;
+    params?: Record<string, unknown>;
+};
+type FormState = {
+    values: FormValues;
+    errors: FormErrors;
+    touched: FormTouched;
+    dirty: boolean;
+    isValid: boolean;
+    isSubmitting: boolean;
+    submitCount: number;
+    issues: ValidationIssue[];
+};
+
+export type { DeclarativeValidatorConfig as D, FieldConfig as F, ValidationIssue as V, Field as a, DeclarativeValidatorType as b, FieldOption as c, FormErrors as d, FormState as e, FormTouched as f, FormValues as g };

package/dist/types-CyAE6ZLH.d.ts

@@ -0,0 +1,19 @@
+import React__default from 'react';
+
+type UIInlineEditorMode = "primitive" | "json" | "translation";
+type UIInlineEditorState = {
+    nodeId: string;
+    propName: string;
+    value: string;
+    multiline: boolean;
+    mode: UIInlineEditorMode;
+    editorStyle?: React__default.CSSProperties;
+};
+type UIInlineTextEditorProps = {
+    editing: UIInlineEditorState;
+    onChange: (value: string) => void;
+    onCancel: () => void;
+    onCommit: () => void;
+};
+
+export type { UIInlineEditorMode as U, UIInlineEditorState as a, UIInlineTextEditorProps as b };

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+import { UISchemaNodeMeta as UISchemaNodeMeta$1 } from '@arkcit/engine-schema';
+export { UIExprValue, UII18nValue, UINode, UINodeEventName, UINodeLayout, UINodeProps, UIRefValue, UIRenderBindingMeta, UISchema, UISchemaNodeMeta, UIValue } from '@arkcit/engine-schema';
+export { UIActionRef, UIRuntime, UIRuntimeAdapter } from '@arkcit/engine-runtime';
+export { U as UIInlineEditingMode, a as UIInlineEditingState, U as UIInlineEditorMode, a as UIInlineEditorState, b as UIInlineTextEditorProps } from './types-CyAE6ZLH.js';
+export { ResolvedEngineNode, ResolvedNode, ResolvedNodeBase, ResolvedNodeChildDescriptor, ResolvedNodeContentDescriptor } from '@arkcit/engine-render-layer';
+export { ComponentRegistry, ComponentRegistryEntry, ReactWebRendererProps, RuntimeRenderInput, SchemaRenderInput, StudioAuthoringProps, UIEngineProps, UINodeDropPreview, UINodeDropState, UINodeDropTarget, UINodeSize, UINodeWrapperProps } from '@arkcit/engine-core';
+import 'react';
+
+type UISchemaNodeMeta = UISchemaNodeMeta$1;
+type UIAuthoringMeta = {
+    [key: string]: unknown;
+};
+type UIInternalNodeMeta = UISchemaNodeMeta & UIAuthoringMeta;
+type UIStudioNodeMeta = UIInternalNodeMeta;
+
+export type { UIAuthoringMeta, UIInternalNodeMeta, UIStudioNodeMeta };

package/dist/wizardEditingHandlers-D50tR-6n.d.ts

@@ -0,0 +1,163 @@
+import React__default, { Dispatch, SetStateAction } from 'react';
+import { F as FieldConfig } from './types-9TZ2lQDP.js';
+import { UINode } from '@arkcit/engine-schema';
+import { UIRuntime } from '@arkcit/engine-runtime';
+
+declare const resolveStudioFormNextValues: ({ formValues, fieldName, nextValue, }: {
+    formValues: Record<string, unknown>;
+    fieldName: string;
+    nextValue: unknown;
+}) => Record<string, unknown>;
+declare const resolveStudioFormResetValues: (normalizedFormFields: Array<FieldConfig & Record<string, unknown>>) => Record<string, unknown>;
+declare const patchStudioFormFieldNode: ({ child, formValues, formErrors, formDict, formLoaderType, fieldOnChange, }: {
+    child: UINode;
+    formValues: Record<string, unknown>;
+    formErrors: Record<string, unknown>;
+    formDict: Record<string, string>;
+    formLoaderType: unknown;
+    fieldOnChange: (event: React__default.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => void;
+}) => {
+    patchedFieldNode: UINode;
+    fieldBasis: string;
+};
+
+type ResolvedStudioFormStructure = {
+    normalizedChildren: UINode[];
+    titleNode?: UINode;
+    fieldNodes: UINode[];
+    submitNode?: UINode;
+    resetNode?: UINode;
+    externalChildren: UINode[];
+    normalizedFormFields: Array<FieldConfig & Record<string, unknown>>;
+    formValues: Record<string, unknown>;
+    formErrors: Record<string, unknown>;
+    formDict: Record<string, string>;
+    formLoaderType: unknown;
+};
+declare const resolveStudioFormStructure: ({ componentProps, visibleChildren, }: {
+    componentProps: Record<string, unknown>;
+    visibleChildren: UINode[];
+}) => ResolvedStudioFormStructure;
+
+type ResolvedStudioAccordionState = {
+    validItemIds: Set<string>;
+    effectiveOpenIds: string[];
+};
+declare const resolveStudioAccordionState: ({ nodeId, accordionChildren, itemIds, selectedNodeId, accordionOpenIdsByNodeId, allowMultiple, }: {
+    nodeId: string;
+    accordionChildren: UINode[];
+    itemIds: string[];
+    selectedNodeId: string | null;
+    accordionOpenIdsByNodeId: Record<string, string[]>;
+    allowMultiple: boolean;
+}) => ResolvedStudioAccordionState;
+declare const resolveStudioExpandablePanelState: ({ nodeId, expandablePanelOpenByNodeId, }: {
+    nodeId: string;
+    expandablePanelOpenByNodeId: Record<string, boolean>;
+}) => {
+    controlledOpen: boolean;
+    defaultOpen: true;
+    disableAnimation: true;
+};
+
+declare const normalizeStudioTabsProps: (props: Record<string, unknown>) => Record<string, unknown>;
+declare const resolveStudioTabsContent: ({ tabItems, rawChildren, runtime, renderChild, normalizeRenderableChild, }: {
+    tabItems: Array<Record<string, unknown>>;
+    rawChildren: UINode[];
+    runtime: UIRuntime;
+    renderChild: (node: UINode) => unknown;
+    normalizeRenderableChild: (value: unknown) => unknown;
+}) => {
+    id: string;
+    title: {};
+    label: {};
+    content: unknown;
+}[];
+declare const resolveStudioTabsProps: ({ componentProps, tabItems, rawChildren, runtime, renderChild, normalizeRenderableChild, }: {
+    componentProps: Record<string, unknown>;
+    tabItems: Array<Record<string, unknown>>;
+    rawChildren: UINode[];
+    runtime: UIRuntime;
+    renderChild: (node: UINode) => unknown;
+    normalizeRenderableChild: (value: unknown) => unknown;
+}) => {
+    normalizedProps: Record<string, unknown>;
+    resolvedTabs: {
+        id: string;
+        title: {};
+        label: {};
+        content: unknown;
+    }[];
+};
+
+declare const resolveStudioWizardNextValues: ({ rawWizardValues, fieldName, nextValue, }: {
+    rawWizardValues: Record<string, unknown>;
+    fieldName: string;
+    nextValue: unknown;
+}) => Record<string, unknown>;
+declare const resolveStudioWizardActiveStepFields: ({ stepId, stepIdToNode, }: {
+    stepId: string;
+    stepIdToNode: Record<string, UINode>;
+}) => Array<FieldConfig & Record<string, unknown>>;
+declare const resolveStudioWizardNextErrors: ({ currentWizardErrors, activeStepFields, nextValues, runtime, }: {
+    currentWizardErrors: Record<string, unknown>;
+    activeStepFields: Array<FieldConfig & Record<string, unknown>>;
+    nextValues: Record<string, unknown>;
+    runtime: UIRuntime;
+}) => Record<string, unknown>;
+declare const patchStudioWizardFieldNode: ({ nested, rawWizardValues, currentWizardErrors, fieldOnChange, }: {
+    nested: UINode;
+    rawWizardValues: Record<string, unknown>;
+    currentWizardErrors: Record<string, unknown>;
+    fieldOnChange: (event: React__default.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => void;
+}) => {
+    patchedNode: UINode;
+    fieldBasis: string;
+};
+
+type ResolvedStudioWizardStep = {
+    id: string;
+    title: unknown;
+    description: unknown;
+    titleNode?: UINode;
+    descriptionNode?: UINode;
+    contentNode?: UINode;
+    isValid: boolean;
+    contentType: "content" | "form";
+    stepRenderableContent: UINode[];
+    contentValue: unknown;
+};
+type ResolvedStudioWizardStructure = {
+    stepChildren: UINode[];
+    stepIdToNode: Record<string, UINode>;
+    selectedStepId: string | null;
+    currentSteps: ResolvedStudioWizardStep[];
+    normalizedFieldsByStep: Record<string, unknown[]>;
+    resolvedActiveStepId: string;
+    existingFormConfig: Record<string, unknown>;
+    existingStudioConfig: Record<string, unknown>;
+};
+declare const resolveStudioWizardStructure: ({ node, componentProps, selectedNodeId, wizardActiveStepByNodeId, runtime, internalStudioNodeTypes, }: {
+    node: UINode;
+    componentProps: Record<string, unknown>;
+    selectedNodeId: string | null;
+    wizardActiveStepByNodeId: Record<string, string>;
+    runtime: UIRuntime;
+    internalStudioNodeTypes: Set<string>;
+}) => ResolvedStudioWizardStructure;
+
+declare const createStudioWizardOnStepChange: ({ nodeId, stepIdToNode, setWizardActiveStepByNodeId, existingOnStepChange, onNodeClick, }: {
+    nodeId: string;
+    stepIdToNode: Record<string, UINode>;
+    setWizardActiveStepByNodeId: Dispatch<SetStateAction<Record<string, string>>>;
+    existingOnStepChange: unknown;
+    onNodeClick?: (nodeId: string) => void;
+}) => (stepId: string) => void;
+declare const attachStudioWizardEditingHandlers: ({ studioConfig, node, stepIdToNode, openInlineEditorForNodeProp, }: {
+    studioConfig: Record<string, unknown>;
+    node: UINode;
+    stepIdToNode: Record<string, UINode>;
+    openInlineEditorForNodeProp: (targetNodeId: string, propName: string, rawValue: unknown) => void;
+}) => Record<string, unknown>;
+
+export { type ResolvedStudioWizardStep as R, attachStudioWizardEditingHandlers as a, patchStudioWizardFieldNode as b, createStudioWizardOnStepChange as c, resolveStudioExpandablePanelState as d, resolveStudioFormNextValues as e, resolveStudioFormResetValues as f, resolveStudioFormStructure as g, resolveStudioTabsContent as h, resolveStudioTabsProps as i, resolveStudioWizardActiveStepFields as j, resolveStudioWizardNextErrors as k, resolveStudioWizardNextValues as l, resolveStudioWizardStructure as m, normalizeStudioTabsProps as n, type ResolvedStudioAccordionState as o, patchStudioFormFieldNode as p, type ResolvedStudioFormStructure as q, resolveStudioAccordionState as r, type ResolvedStudioWizardStructure as s };

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@arkcit/engine",
+  "version": "0.3.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Shared web adapter-layer package for the Arkcit engine platform, hosting the web integration path around extracted concrete renderers.",
+  "license": "UNLICENSED",
+  "keywords": [
+    "arkcit",
+    "engine",
+    "ui-engine",
+    "renderer",
+    "web"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Arkcit/engine.git"
+  },
+  "homepage": "https://github.com/Arkcit/engine",
+  "bugs": {
+    "url": "https://github.com/Arkcit/engine/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./UIEngine": {
+      "types": "./dist/UIEngine.d.ts",
+      "import": "./dist/UIEngine.js",
+      "default": "./dist/UIEngine.js"
+    },
+    "./bindings": {
+      "types": "./dist/bindings.d.ts",
+      "import": "./dist/bindings.js",
+      "default": "./dist/bindings.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./form": {
+      "types": "./dist/form.d.ts",
+      "import": "./dist/form.js",
+      "default": "./dist/form.js"
+    },
+    "./form/engineFormValidation": {
+      "types": "./dist/form/engineFormValidation.d.ts",
+      "import": "./dist/form/engineFormValidation.js",
+      "default": "./dist/form/engineFormValidation.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js",
+      "default": "./dist/registry.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js",
+      "default": "./dist/components/index.js"
+    },
+    "./renderers": {
+      "types": "./dist/renderers/index.d.ts",
+      "import": "./dist/renderers/index.js",
+      "default": "./dist/renderers/index.js"
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.js",
+      "default": "./dist/layout.js"
+    },
+    "./preview": {
+      "types": "./dist/preview/index.d.ts",
+      "import": "./dist/preview/index.js",
+      "default": "./dist/preview/index.js"
+    },
+    "./render-layer": {
+      "types": "./dist/render-layer/index.d.ts",
+      "import": "./dist/render-layer/index.js",
+      "default": "./dist/render-layer/index.js"
+    },
+    "./react-web": {
+      "types": "./dist/react-web/index.d.ts",
+      "import": "./dist/react-web/index.js",
+      "default": "./dist/react-web/index.js"
+    },
+    "./studio-props": {
+      "types": "./dist/studioProps.d.ts",
+      "import": "./dist/studioProps.js",
+      "default": "./dist/studioProps.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js",
+      "default": "./dist/schema/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./studio-bridge": {
+      "types": "./dist/studio-bridge/index.d.ts",
+      "import": "./dist/studio-bridge/index.js",
+      "default": "./dist/studio-bridge/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:smoke": "tsx src/__tests__/public-entrypoints.test.ts",
+    "test:node": "tsx src/__tests__/run-all.ts",
+    "test:react": "vitest --configLoader runner run src/utils/__tests__/contentStudio.test.tsx src/utils/__tests__/overlayStudio.test.ts src/utils/__tests__/navigationStudio.test.tsx src/utils/__tests__/renderChildren.test.tsx src/utils/__tests__/nodeWrapperStudio.test.tsx src/renderers/renderStudioForm.test.tsx src/renderers/configureStudioNavigation.test.tsx src/renderers/configureStudioLink.test.ts src/renderers/configureStudioFormWizard.test.tsx src/renderers/renderBoundTable.test.tsx src/components/InlineTextEditor.test.tsx src/components/NodeErrorBoundary.test.tsx src/UIEngine.test.tsx",
+    "test": "npm run test:smoke && npm run test:node && npm run test:react"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "dependencies": {
+    "@arkcit/engine-core": "^0.3.0",
+    "@arkcit/engine-react": "^0.3.0",
+    "@arkcit/engine-render-layer": "^0.3.0",
+    "@arkcit/engine-runtime": "^0.3.0",
+    "@arkcit/engine-schema": "^0.3.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitest/coverage-v8": "^4.1.0",
+    "c8": "^11.0.0",
+    "jsdom": "^28.1.0",
+    "tsx": "^4.21.0",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.0"
+  }
+}