@sparqjs/schema-designer 0.1.0

package/dist/extensions/instance.d.ts

@@ -0,0 +1,56 @@
+import type { ResourceField, SchemaResource, ViewNode } from '@sparqjs/schema-protocol';
+/** Designer 输出范围；form 只保留字段定义和表单视图。 */
+export type DesignerOutputScope = 'resource' | 'form';
+/** 宿主按设计场景控制 Designer 的通用入口，不在核心内识别具体业务模块。 */
+export interface DesignerFeatureOptions {
+    resourceTree?: boolean;
+    templates?: boolean;
+    formProperties?: boolean;
+    deviceModes?: boolean;
+    importJson?: boolean;
+    exportJson?: boolean;
+    preview?: boolean;
+    jsonView?: boolean;
+}
+/** Designer 内部使用的完整能力开关。 */
+export type ResolvedDesignerFeatures = Required<DesignerFeatureOptions>;
+export declare const defaultDesignerFeatures: ResolvedDesignerFeatures;
+/** 补齐宿主未声明的入口，保持现有 Designer 实例行为不变。 */
+export declare function resolveDesignerFeatures(features?: DesignerFeatureOptions): ResolvedDesignerFeatures;
+/** 单个表单节点可执行的操作；未声明的布尔项默认允许。 */
+export interface DesignerNodePermissions {
+    selectable?: boolean;
+    editable?: boolean;
+    movable?: boolean;
+    copyable?: boolean;
+    deletable?: boolean;
+    /** 允许成为直接父级的节点 ID；null 表示当前表单根级。 */
+    allowedParentIds?: readonly (string | null)[];
+}
+/** 节点权限解析器获得的当前草稿上下文。 */
+export interface DesignerNodePermissionContext {
+    node: ViewNode;
+    parent?: ViewNode;
+    field?: ResourceField;
+    schema: SchemaResource;
+    viewName: string;
+}
+/** 宿主按节点、字段或父容器动态声明权限，不把业务所有权写入 Designer。 */
+export type DesignerNodePermissionResolver = (context: DesignerNodePermissionContext) => DesignerNodePermissions | undefined;
+/** 解析后的节点权限包含完整默认值，调用方无需重复补齐缺省项。 */
+export interface ResolvedDesignerNodePermissions {
+    selectable: boolean;
+    editable: boolean;
+    movable: boolean;
+    copyable: boolean;
+    deletable: boolean;
+    allowedParentIds?: readonly (string | null)[];
+}
+/** 当前实例统一使用的节点权限策略。 */
+export interface DesignerNodePermissionPolicy {
+    resolve(context: DesignerNodePermissionContext): ResolvedDesignerNodePermissions;
+}
+export declare const defaultDesignerNodePermissions: ResolvedDesignerNodePermissions;
+/** 将宿主权限结果补齐为不可受外部数组后续修改影响的实例策略。 */
+export declare function createDesignerNodePermissionPolicy(resolver?: DesignerNodePermissionResolver): DesignerNodePermissionPolicy;
+//# sourceMappingURL=instance.d.ts.map

package/dist/extensions/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/extensions/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEvF,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,MAAM,CAAA;AAErD,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACnC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,4BAA4B;AAC5B,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,sBAAsB,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,EAAE,wBASpC,CAAA;AAEF,uCAAuC;AACvC,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,wBAAwB,CAEnG;AAED,gCAAgC;AAChC,MAAM,WAAW,uBAAuB;IACpC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAChD;AAED,yBAAyB;AACzB,MAAM,WAAW,6BAA6B;IAC1C,IAAI,EAAE,QAAQ,CAAA;IACd,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,6CAA6C;AAC7C,MAAM,MAAM,8BAA8B,GAAG,CACzC,OAAO,EAAE,6BAA6B,KACrC,uBAAuB,GAAG,SAAS,CAAA;AAExC,oCAAoC;AACpC,MAAM,WAAW,+BAA+B;IAC5C,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAChD;AAED,uBAAuB;AACvB,MAAM,WAAW,4BAA4B;IACzC,OAAO,CAAC,OAAO,EAAE,6BAA6B,GAAG,+BAA+B,CAAA;CACnF;AAED,eAAO,MAAM,8BAA8B,EAAE,+BAM3C,CAAA;AAEF,oCAAoC;AACpC,wBAAgB,kCAAkC,CAC9C,QAAQ,CAAC,EAAE,8BAA8B,GAC1C,4BAA4B,CAkB9B"}

package/dist/extensions/material.d.ts

@@ -0,0 +1,49 @@
+import type { ResourceField, ViewNode } from '@sparqjs/schema-protocol';
+/** 左侧物料所在的稳定分类；分类只控制设计器展示位置，不写入业务 schema。 */
+export type DesignerMaterialCategory = 'form' | 'function' | 'layout';
+/** 字段物料工厂获得的唯一字段名，由设计器在调用工厂前完成冲突处理。 */
+export interface DesignerFieldMaterialContext {
+    fieldName: string;
+}
+/** 普通节点物料工厂上下文；保留对象参数便于后续增加稳定的实例信息。 */
+export type DesignerNodeMaterialContext = Readonly<Record<string, never>>;
+/** 字段物料必须同时返回字段协议和引用该字段的视图节点。 */
+export interface DesignerFieldMaterialResult {
+    field: ResourceField;
+    node: ViewNode;
+}
+/** 普通节点物料只创建视图节点，不能隐式增加 ResourceField。 */
+export interface DesignerNodeMaterialResult {
+    node: ViewNode;
+    field?: never;
+}
+interface DesignerMaterialBase {
+    /** 实例内稳定物料 key，用于覆盖诊断和拖拽载荷解析。 */
+    key: string;
+    /** Sidebar 中显示的物料标题。 */
+    title: string;
+    /** 可选补充说明；当前 Sidebar 不展示时仍可供后续搜索使用。 */
+    description?: string;
+    /** Designer 内置语义图标 key，插件不能注入任意 HTML 或样式类。 */
+    icon: string;
+    /** 物料在 Sidebar 中的稳定分类。 */
+    category: DesignerMaterialCategory;
+}
+/** 创建 ResourceField 与 ViewNode 的字段物料。 */
+export interface DesignerFieldMaterial extends DesignerMaterialBase {
+    kind: 'field';
+    /** 生成唯一字段名时使用的语义基础值，不从可修改标题推导。 */
+    fieldNameBase: string;
+    /** 使用设计器分配的字段名创建完整字段协议和节点。 */
+    create(context: DesignerFieldMaterialContext): DesignerFieldMaterialResult;
+}
+/** 创建布局、功能视图等不新增字段的节点物料。 */
+export interface DesignerNodeMaterial extends DesignerMaterialBase {
+    kind: 'node';
+    /** 创建完整节点树；返回结果在提交前仍会经过结构校验和 ID 重建。 */
+    create(context: DesignerNodeMaterialContext): DesignerNodeMaterialResult;
+}
+/** DesignerExtension 可贡献的实例级物料联合类型。 */
+export type DesignerMaterial = DesignerFieldMaterial | DesignerNodeMaterial;
+export {};
+//# sourceMappingURL=material.d.ts.map

package/dist/extensions/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../src/extensions/material.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEvE,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAA;AAErE,uCAAuC;AACvC,MAAM,WAAW,4BAA4B;IACzC,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,uCAAuC;AACvC,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAEzE,iCAAiC;AACjC,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,QAAQ,CAAA;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,CAAC,EAAE,KAAK,CAAA;CAChB;AAED,UAAU,oBAAoB;IAC1B,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,QAAQ,EAAE,wBAAwB,CAAA;CACrC;AAED,yCAAyC;AACzC,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IAC/D,IAAI,EAAE,OAAO,CAAA;IACb,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,MAAM,CAAC,OAAO,EAAE,4BAA4B,GAAG,2BAA2B,CAAA;CAC7E;AAED,4BAA4B;AAC5B,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,MAAM,CAAC,OAAO,EAAE,2BAA2B,GAAG,0BAA0B,CAAA;CAC3E;AAED,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,oBAAoB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { Shell as SparqDesigner } from './app/root';
+export { createCanvasAdapter } from './canvas/adapter';
+export { SortableList } from './canvas/sortable-list';
+export { createDesignerOutputSchema } from './state/output';
+export { createDesignerExtensionContext, type DesignerExtension, type DesignerExtensionContext, type DesignerExtensionContextOptions, type DesignerExtensionDiagnostic, type DesignerExtensionDiagnosticCode, } from './extensions/context';
+export { createDesignerNodePermissionPolicy, defaultDesignerFeatures, defaultDesignerNodePermissions, resolveDesignerFeatures, type DesignerFeatureOptions, type DesignerNodePermissionContext, type DesignerNodePermissionPolicy, type DesignerNodePermissionResolver, type DesignerNodePermissions, type DesignerOutputScope, type ResolvedDesignerNodePermissions, type ResolvedDesignerFeatures, } from './extensions/instance';
+export type { DesignerFieldMaterial, DesignerFieldMaterialContext, DesignerFieldMaterialResult, DesignerMaterial, DesignerMaterialCategory, DesignerNodeMaterial, DesignerNodeMaterialContext, DesignerNodeMaterialResult, } from './extensions/material';
+export { designerFieldCapabilityKeys, type DesignerComponentFieldCapability, type DesignerComponentMigrationChange, type DesignerComponentMigrationContext, type DesignerComponentMigrationResult, type DesignerComponentMigrator, type DesignerComponentCapabilityProfile, type DesignerComponentOption, type DesignerComponentPropertyConfig, type DesignerComponentValidationConfig, type DesignerDefaultValueEditor, type DesignerMultiplePolicy, type DesignerOptionSourceMode, type DesignerValueStrategyMode, } from './inspector/field-schema';
+export { designerCapabilityCardKeys, type DesignerCapabilityCard, type DesignerCapabilityField, type DesignerCapabilityCardKey, type DesignerCapabilityCardGroup, type DesignerCapabilityPath, type DesignerCapabilitySummary, type DesignerCapabilitySummaryStatus, } from './inspector/capabilities';
+export type { FieldPropertyCommitMode, FieldPropertyDataSource, FieldPropertyEditLevel, FieldPropertyField, FieldPropertyMigrationOwner, FieldPropertyStorage, FieldSchemaContext, FieldSchemaSection, } from './inspector/field-schema';
+export type { DesignerServiceContext, DesignerServiceOption, DesignerServiceProvider, DesignerServiceRegistry, } from './services/registry';
+export type { DesignerComponentFieldTypeConfig, DesignerFieldType, DesignerFieldTypeOption, } from './state/component-config';
+export type { DeviceMode, DesignerHandle, DraftState, RootProps, Selection } from './state/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EACH,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,GACvC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACH,kCAAkC,EAClC,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAChC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACR,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,2BAA2B,EAC3B,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,EACtC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GACjC,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACH,0BAA0B,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,GACvC,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACR,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACR,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACR,gCAAgC,EAChC,iBAAiB,EACjB,uBAAuB,GAC1B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA"}