@vvfx/artis 0.0.1-alpha.0

package/dist/core/types/item-create-info.d.ts

@@ -0,0 +1,205 @@
+import type { spec } from '../../shared';
+import type { ArtisItemType, CardItem } from '../item';
+import type { FrameLayoutMode, AutoLayoutConfig, LayoutInfo } from './frame';
+import type { CardHTML } from './item-property';
+export type SpriteCreateInfo = {
+    type: ArtisItemType.SPRITE;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    extension?: Record<string, any>;
+    property: {
+        image?: string;
+        /** 像素宽度，缺省 = auto 自适应（资源就绪后按原生尺寸收敛，占位 300×300） */
+        width?: number;
+        /** 像素高度，缺省 = auto 自适应 */
+        height?: number;
+        /** 像素位置，缺省 [0,0] */
+        position?: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        /** 尺寸模式，缺省按 width/height 是否指定推导（任一缺省 → auto） */
+        sizeMode?: 'auto' | 'fixed';
+    };
+};
+export type GroupCreateInfo = {
+    type: ArtisItemType.GROUP;
+    id?: string;
+    parentId?: string;
+    name?: string;
+    extension?: Record<string, any>;
+    property: {
+        position?: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        children: string[];
+    };
+};
+export type TextCreateInfo = {
+    type: ArtisItemType.TEXT;
+    id?: string;
+    parentId?: string;
+    name?: string;
+    extension?: Record<string, any>;
+    property: {
+        width: number;
+        height?: number;
+        position: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        lineHeight: number;
+        fontFamily: string;
+        fontSize: number;
+        fontWeight?: spec.TextWeight;
+        fontStyle?: spec.FontStyle;
+        textAlign?: spec.TextAlignment;
+        text: string;
+        color: spec.vec4;
+        outlineColor?: spec.vec4;
+        outlineWidth?: number;
+        outlineEnabled?: boolean;
+        fontUrl?: string;
+        letterSpacing?: number;
+    };
+};
+export type VideoCreateInfo = {
+    type: ArtisItemType.VIDEO;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    extension?: Record<string, any>;
+    property: {
+        video?: string;
+        /** 像素宽度，缺省 = auto 自适应（资源就绪后按原生尺寸收敛，占位 400×300） */
+        width?: number;
+        /** 像素高度，缺省 = auto 自适应 */
+        height?: number;
+        /** 像素位置，缺省 [0,0] */
+        position?: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        muted?: boolean;
+        transparent?: boolean;
+        playbackRate?: number;
+        volume?: number;
+        /** 尺寸模式，缺省按 width/height 是否指定推导（任一缺省 → auto） */
+        sizeMode?: 'auto' | 'fixed';
+    };
+};
+export type CardType = string;
+export type CardCreateInfo = {
+    type: ArtisItemType.CARD;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    extension?: Record<string, any>;
+    property: {
+        cardType: CardType;
+        width: number;
+        height: number;
+        autoHeight?: boolean;
+        position: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        html?: CardHTML;
+    };
+};
+export declare enum GeneratorType {
+    IMAGE = "image",
+    VIDEO = "video"
+}
+export type GeneratorCreateInfo = {
+    type: ArtisItemType.GENERATOR;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    extension?: Record<string, any>;
+    property: {
+        generatorType: GeneratorType;
+        width: number;
+        height: number;
+        position: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+    };
+};
+export type EffectsCreateInfo = {
+    type: ArtisItemType.EFFECTS;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    property: {
+        width?: number;
+        height?: number;
+        position: spec.vec2;
+        rotation?: number | [number, number, number];
+        scale?: spec.vec2;
+        effects?: string;
+        /**
+         * 是否自适应大小（只读，初值在 create 期锁定后不再改）。
+         * - 未显式传时：width/height 任一缺省即为 true（元素大小随资源主合成自适应）。
+         * - 显式传 true/false 时：以传入值为准。
+         * false：加载/切换资源时元素大小不变（create 期定死）。
+         * true：加载/切换资源时元素大小随新资源主合成 previewSize 变化。
+         */
+        autoFit?: boolean;
+    };
+    extension?: Record<string, any>;
+};
+export type FrameCreateInfo = {
+    type: ArtisItemType.FRAME;
+    name?: string;
+    id?: string;
+    parentId?: string;
+    property: {
+        width: number;
+        height: number;
+        position: [number, number];
+        rotation?: number | [number, number, number];
+        scale?: [number, number];
+        layoutMode?: FrameLayoutMode;
+        children: string[];
+        autoLayoutConfig?: AutoLayoutConfig;
+        layoutInfos?: Record<string, LayoutInfo>;
+    };
+    extension?: Record<string, any>;
+};
+export type AsyncSpriteCreateInfo = SpriteCreateInfo & {
+    textureId: string;
+};
+export type AsyncVideoCreateInfo = VideoCreateInfo & {
+    textureId: string;
+};
+export type ItemCreateInfo = GroupCreateInfo | SpriteCreateInfo | TextCreateInfo | VideoCreateInfo | GeneratorCreateInfo | EffectsCreateInfo | FrameCreateInfo | CardCreateInfo;
+export type AsyncItemCreateInfo = GroupCreateInfo | TextCreateInfo | AsyncSpriteCreateInfo | AsyncVideoCreateInfo;
+/**
+ * 场景创建信息（createSceneByCreateInfos 的 sceneInfo 入参）。
+ * 注：原名 SceneCreaetInfo（拼写错误），已纠正为 SceneCreateInfo。
+ */
+export type SceneCreateInfo = {
+    name: string;
+    size: spec.vec2;
+};
+/**
+ * 卡片类型配置条目（原 core/config.ts，随 SDKConfig 僵尸结构清理迁入）。
+ */
+export type CardTypeConfig = {
+    /** 卡片类型标识 */
+    type: string;
+    /** 卡片类型显示名称 */
+    label: string;
+    /** ResizeSelectionGizmo 左上角展示的 icon URL */
+    iconUrl: string;
+    /** 由 cardType 动态解析的 HTML 渲染配置，不进入序列化数据。 */
+    html?: (item: CardItem) => CardHTML | undefined;
+    /** 是否按 HTML 内容自然高度更新卡片高度。 */
+    autoHeight?: boolean;
+    /** 自动高度锚点，默认保持顶部不动。 */
+    autoHeightAnchor?: 'top' | 'center';
+    /** HTML 内容是否跟随卡片 scale 缩放，默认 true。 */
+    autoScale?: boolean;
+    /** 是否启用双击编辑态，默认 true。 */
+    editable?: boolean;
+    /** 非编辑态可直接响应事件的额外选择器。 */
+    htmlInteractionSelectors?: string[];
+};

package/dist/core/types/item-property.d.ts

@@ -0,0 +1,149 @@
+import { GeneratorType } from './item-create-info';
+import { FrameLayoutMode, type AutoLayoutConfig, type LayoutInfo } from './frame';
+import { type spec } from '../../shared';
+export type BaseItemProperty = {
+    position: [number, number];
+    rotation: [number, number, number];
+    scale: [number, number];
+    width: number;
+    height: number;
+};
+export type SpriteItemProperty = BaseItemProperty & {
+    image: string;
+    /**
+     * 尺寸模式：'auto'=随资源原生尺寸自适应（未拿资源前占位 300×300）；'fixed'=尺寸定死，换源不改。
+     * 缺省等价 'fixed'（兼容旧档——旧档尺寸显式给定）。auto→fixed 在用户显式设尺寸（item.transform 带
+     * width/height）时翻转；gizmo 拖拽改 scale 不翻状态。状态字段本身不单独进 undo（尺寸变更已进 undo）。
+     */
+    sizeMode?: 'auto' | 'fixed';
+};
+export type GroupItemProperty = BaseItemProperty & {
+    children: string[];
+};
+export type TextItemProperty = BaseItemProperty & {
+    fontFamily: string;
+    color: [number, number, number, number];
+    fontWeight: spec.TextWeight;
+    text: string;
+    textAlign: spec.TextAlignment;
+    fontSize: number;
+    fontStyle: spec.FontStyle;
+    lineHeight: number;
+    outlineColor?: spec.vec4;
+    outlineWidth?: number;
+    outlineEnabled?: boolean;
+    letterSpacing?: number;
+    fontUrl?: string;
+};
+export type VideoItemProperty = BaseItemProperty & {
+    video: string;
+    muted?: boolean;
+    transparent?: boolean;
+    playbackRate?: number;
+    volume?: number;
+    /**
+     * 尺寸模式：'auto'=随资源原生尺寸自适应（未拿资源前占位 400×300）；'fixed'=尺寸定死，换源不改。
+     * 缺省等价 'fixed'（兼容旧档）。auto→fixed 在用户显式设尺寸时翻转；gizmo 改 scale 不翻状态。
+     */
+    sizeMode?: 'auto' | 'fixed';
+};
+/**
+ * Generator 表单属性
+ */
+export type GeneratorItemProperty = BaseItemProperty & {
+    generatorType: GeneratorType;
+};
+export type EffectsItemProperty = BaseItemProperty & {
+    effects: string;
+    children?: string[];
+    /**
+     * 是否自适应大小（只读，初值在 create 期锁定后不再改、不暴露 UI、不进 undo）。
+     * true：加载/切换资源时元素大小随新资源主合成 previewSize 变化；
+     * false：加载/切换资源时元素大小不变（create 期定死）。
+     */
+    autoFit?: boolean;
+};
+export type CardHTMLRenderCleanup = () => void;
+export type CardHTMLContentCleanup = (container: HTMLElement) => void;
+export type CardHTMLDOMRenderer = (container: HTMLElement) => void;
+export type CardHTMLPatchContext = {
+    id: string;
+    html: CardHTML;
+    content: CardHTMLContent;
+    container?: HTMLElement;
+    contentWindow?: Window | null;
+    refresh: () => void;
+};
+export type CardHTMLPatchHandler = (patch: unknown, context: CardHTMLPatchContext) => boolean | undefined;
+export type CardHTMLWindowEventMessage = {
+    source: 'vvfx-card-html-event';
+    type: string;
+    detail?: unknown;
+    payload?: unknown;
+};
+export type CardHTMLInlineContent = {
+    kind: 'inline';
+    html: string;
+    sandbox?: boolean | string;
+    allowAnchorNavigation?: boolean;
+    patch?: CardHTMLPatchHandler;
+    cleanup?: CardHTMLContentCleanup;
+};
+export type CardHTMLDOMRendererContent = {
+    kind: 'dom';
+    target?: 'host' | 'iframe';
+    render: CardHTMLDOMRenderer;
+    patch?: CardHTMLPatchHandler;
+    cleanup?: CardHTMLContentCleanup;
+};
+export type CardHTMLDocumentMessage = {
+    source: 'vvfx-card-html';
+    type: string;
+    payload?: unknown;
+};
+export type CardHTMLDocumentContent = {
+    kind: 'document';
+    entry: string;
+    files: Record<string, string>;
+    baseUrl?: string;
+    sandbox?: boolean | string;
+    allowAnchorNavigation?: boolean;
+    allowHostMessaging?: boolean;
+    onMessage?: (message: CardHTMLDocumentMessage) => void;
+    patch?: CardHTMLPatchHandler;
+    cleanup?: CardHTMLContentCleanup;
+};
+export type CardHTMLContent = CardHTMLInlineContent | CardHTMLDOMRendererContent | CardHTMLDocumentContent;
+export type CardHTMLShellRendererResult = HTMLElement | {
+    contentContainer: HTMLElement;
+    cleanup?: CardHTMLRenderCleanup;
+};
+export type CardHTMLShellRendererContext = {
+    content: CardHTMLContent;
+};
+export type CardHTMLShellRenderer = (container: HTMLElement, context: CardHTMLShellRendererContext) => CardHTMLShellRendererResult;
+export type CardHTMLShellContent = {
+    kind: 'dom';
+    render: CardHTMLShellRenderer;
+};
+export type CardHTMLRootStyle = Record<string, string | number | undefined>;
+export type CardHTMLRootConfig = {
+    className?: string;
+    style?: CardHTMLRootStyle;
+};
+export type CardHTML = {
+    content: CardHTMLContent;
+    shell?: CardHTMLShellContent;
+    root?: CardHTMLRootConfig;
+};
+export type CardItemProperty = BaseItemProperty & {
+    cardType: string;
+    autoHeight?: boolean;
+    html?: CardHTML;
+};
+export type FrameItemProperty = BaseItemProperty & {
+    layoutMode: FrameLayoutMode;
+    children: string[];
+    autoLayoutConfig?: AutoLayoutConfig;
+    layoutInfos?: Record<string, LayoutInfo>;
+};

package/dist/core/types/item-reorder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 元素图层操作动作（旧 SDK 兼容枚举，对应新 item.reorder 的 reorderType 字符串）。
+ *
+ * 新代码建议直接使用字符串字面量：
+ * 'bringToFront' | 'sendToBack' | 'bringForward'（moveUp）| 'sendBackward'（moveDown）。
+ */
+export declare enum ItemOrderAction {
+    BringToFront = 0,
+    SendToBack = 1,
+    BringForward = 2,
+    SendBackward = 3
+}

package/dist/core/types/item-schema.d.ts

@@ -0,0 +1,263 @@
+import { type spec } from '../../shared';
+import { type AutoLayoutConfig, type LayoutInfo, type FrameLayoutMode } from './frame';
+import { type CardHTML } from './item-property';
+import { GeneratorType, type ItemCreateInfo } from './item-create-info';
+import { ArtisItemType } from '../item';
+/**
+ * 图片元素 Schema
+ */
+export type SpriteItemSchema = {
+    type: ArtisItemType.SPRITE;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 图片资源地址 */
+        image?: string;
+        /** 像素宽度（不传 → auto 模式占位 300，资源就绪后按原生尺寸回写） */
+        width?: number;
+        /** 像素高度（不传 → auto 模式占位 300，资源就绪后按原生尺寸回写） */
+        height?: number;
+        /** 元素位置，缺省 [0,0] */
+        position?: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 尺寸模式：不传则由 width/height 是否指定推导（任一缺省 → auto） */
+        sizeMode?: 'auto' | 'fixed';
+    };
+};
+/**
+ * 文本元素 Schema
+ */
+export type TextItemSchema = {
+    type: ArtisItemType.TEXT;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 像素宽度 */
+        width: number;
+        /** 像素高度 */
+        height?: number;
+        /** 元素位置 */
+        position: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 文本内容 */
+        text: string;
+        /** 字体大小 */
+        fontSize: number;
+        /** 字体名称 */
+        fontFamily: string;
+        /** 单行高度 */
+        lineHeight: number;
+        /** 填充色 [r, g, b, a] */
+        color: [number, number, number, number];
+        /** 字重 */
+        fontWeight?: spec.TextWeight;
+        /** 字体格式 */
+        fontStyle?: spec.FontStyle;
+        /** 对齐方式 */
+        textAlign?: spec.TextAlignment;
+        /** 描边色 [r, g, b, a] */
+        outlineColor?: [number, number, number, number];
+        /** 描边宽度 */
+        outlineWidth?: number;
+        /** 描边开关 */
+        outlineEnabled?: boolean;
+        /** 字体文件地址 */
+        fontUrl?: string;
+        /** 文本字间距 */
+        letterSpacing?: number;
+    };
+};
+/**
+ * 视频元素 Schema
+ */
+export type VideoItemSchema = {
+    type: ArtisItemType.VIDEO;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 视频资源地址 */
+        video?: string;
+        /** 像素宽度（不传 → auto 模式占位 400，资源就绪后按原生尺寸回写） */
+        width?: number;
+        /** 像素高度（不传 → auto 模式占位 300，资源就绪后按原生尺寸回写） */
+        height?: number;
+        /** 元素位置，缺省 [0,0] */
+        position?: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 是否静音 */
+        muted?: boolean;
+        /** 是否为透明视频 */
+        transparent?: boolean;
+        /** 播放速率 */
+        playbackRate?: number;
+        /** 音量 */
+        volume?: number;
+        /** 尺寸模式：不传则由 width/height 是否指定推导（任一缺省 → auto） */
+        sizeMode?: 'auto' | 'fixed';
+    };
+};
+/**
+ * 空节点/组元素 Schema
+ */
+export type GroupItemSchema = {
+    type: ArtisItemType.GROUP;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 元素位置 */
+        position?: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 子元素 ID 列表 */
+        children: string[];
+    };
+};
+/**
+ * 资源生成器元素 Schema
+ */
+export type GeneratorItemSchema = {
+    type: ArtisItemType.GENERATOR;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 生成器类型 */
+        generatorType: GeneratorType;
+        /** 像素宽度 */
+        width: number;
+        /** 像素高度 */
+        height: number;
+        /** 元素位置 */
+        position: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /**
+         * 资源 URL（可选）。存在时 createItemCore 短路直建 sprite/video（不经生成器中间态）：
+         * image 生成器→sprite(image=url)，video 生成器→video(video=url)。
+         * 缺省时建空生成器占位，行为不变。
+         */
+        resourceUrl?: string;
+    };
+};
+/**
+ * 特效产物元素 Schema
+ */
+export type EffectsItemSchema = {
+    type: ArtisItemType.EFFECTS;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 像素宽度 */
+        width?: number;
+        /** 像素高度 */
+        height?: number;
+        /** 元素位置 */
+        position: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 特效资源地址 */
+        effects?: string;
+        /** 是否自适应大小（只读，初值在 create 期锁定后不再改） */
+        autoFit?: boolean;
+    };
+};
+/**
+ * 画板/框架元素 Schema
+ */
+export type FrameItemSchema = {
+    type: ArtisItemType.FRAME;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 像素宽度 */
+        width: number;
+        /** 像素高度 */
+        height: number;
+        /** 元素位置 */
+        position: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 布局模式 */
+        layoutMode?: FrameLayoutMode;
+        /** 子元素 ID 列表 */
+        children: string[];
+        /** 自动布局配置 */
+        autoLayoutConfig?: AutoLayoutConfig;
+        /** 子元素布局信息 */
+        layoutInfos?: Record<string, LayoutInfo>;
+    };
+};
+/**
+ * 卡片元素 Schema
+ */
+export type CardItemSchema = {
+    type: ArtisItemType.CARD;
+    id?: string;
+    name?: string;
+    parentId?: string;
+    extension?: Record<string, unknown>;
+    property: {
+        /** 卡片类型 */
+        cardType: string;
+        /** 像素宽度 */
+        width: number;
+        /** 像素高度 */
+        height: number;
+        /** 元素位置 */
+        position: [number, number];
+        /** 旋转角度 z | [x, y, z] */
+        rotation?: number | [number, number, number];
+        /** 缩放 */
+        scale?: [number, number];
+        /** 是否自动高度 */
+        autoHeight?: boolean;
+        /** HTML 内容配置 */
+        html?: CardHTML;
+    };
+};
+/**
+ * 统一的元素 Schema（联合类型）
+ *
+ * 由此驱动：
+ * 1. 同步创建 ArtisItem + Player VFXItem
+ * 2. 异步加载资源（image / video / effects）
+ */
+export type ItemSchema = SpriteItemSchema | TextItemSchema | VideoItemSchema | GroupItemSchema | GeneratorItemSchema | EffectsItemSchema | FrameItemSchema | CardItemSchema;
+/**
+ * 将外部 API 入参 ItemCreateInfo 转换为内部 ItemSchema
+ *
+ * ItemCreateInfo 是 ArtisSDK 对外暴露的创建参数类型，
+ * ItemSchema 是内部实现使用的统一数据结构。
+ * 两者字段基本一致，主要差异在 extension 类型（any → unknown）和部分可选字段。
+ */
+export declare function createInfoToItemSchema(createInfo: ItemCreateInfo): ItemSchema;

package/dist/core/types/item-set-property.d.ts

@@ -0,0 +1,48 @@
+import type { spec } from '../../shared';
+import { ArtisItemType } from '../item';
+import type { SpriteItemProperty, TextItemProperty, VideoItemProperty, GroupItemProperty, GeneratorItemProperty, EffectsItemProperty, FrameItemProperty, CardItemProperty } from './item-property';
+export declare enum BaseItemPropertyKey {
+    NAME = "name",
+    DURATION = "duration",
+    DELAY = "delay",
+    END_BEHAVIOR = "endBehavior",
+    VISIBLE = "visible",
+    IS_LOCKED = "isLocked",
+    PARENT_ID = "parentId"
+}
+export type BaseItemPropertyValueMap = {
+    name: string;
+    duration: number;
+    delay: number;
+    endBehavior: spec.EndBehavior;
+    visible: boolean;
+    isLocked: boolean;
+    parentId?: string;
+};
+export type ItemPropertyMap = {
+    [ArtisItemType.SPRITE]: SpriteItemProperty;
+    [ArtisItemType.TEXT]: TextItemProperty;
+    [ArtisItemType.VIDEO]: VideoItemProperty;
+    [ArtisItemType.GROUP]: GroupItemProperty;
+    [ArtisItemType.GENERATOR]: GeneratorItemProperty;
+    [ArtisItemType.EFFECTS]: EffectsItemProperty;
+    [ArtisItemType.FRAME]: FrameItemProperty;
+    [ArtisItemType.CARD]: CardItemProperty;
+};
+export type SetSingleItemSinglePropertyParam<T extends ArtisItemType = ArtisItemType> = {
+    itemId: string;
+    type: T;
+    propertyName: BaseItemPropertyKey;
+    propertyValue: BaseItemPropertyValueMap[BaseItemPropertyKey];
+} | {
+    itemId: string;
+    type: T;
+    propertyName: keyof ItemPropertyMap[T];
+    propertyValue: ItemPropertyMap[T][keyof ItemPropertyMap[T]];
+};
+export type SetSingleItemMultiplePropertiesParam<T extends ArtisItemType = ArtisItemType> = {
+    itemId: string;
+    type: T;
+    property: Partial<Record<BaseItemPropertyKey, BaseItemPropertyValueMap[BaseItemPropertyKey]>> & Partial<Record<keyof ItemPropertyMap[T], ItemPropertyMap[T][keyof ItemPropertyMap[T]]>>;
+};
+export type SetItemPropertyParam<T extends ArtisItemType = ArtisItemType> = SetSingleItemSinglePropertyParam<T> | SetSingleItemMultiplePropertiesParam<T>;