@trojanbox-vcp-test/site-edit-engine 0.1.0

package/dist/internal/protocol/operation.d.ts

@@ -0,0 +1,224 @@
+import type { OperationError } from "./error.js";
+/** caller-facing 操作类型 */
+export type OperationType = "update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata";
+export type OperationValue = string | number | boolean | null | OperationValue[] | {
+    [key: string]: OperationValue;
+};
+export type OperationTarget = {
+    kind: "node";
+    key: string;
+} | {
+    kind: "route";
+    routeId: string;
+};
+export type StyleProperty = "display" | "position" | "top" | "right" | "bottom" | "left" | "zIndex" | "flexDirection" | "flexWrap" | "flexGrow" | "flexShrink" | "flexBasis" | "order" | "gridTemplateColumns" | "gridTemplateRows" | "columns" | "gridColumn" | "gridRow" | "gap" | "gapX" | "gapY" | "spaceX" | "spaceY" | "alignItems" | "justifyContent" | "marginTop" | "marginRight" | "marginBottom" | "marginLeft" | "paddingTop" | "paddingRight" | "paddingBottom" | "paddingLeft" | "width" | "height" | "minWidth" | "minHeight" | "maxWidth" | "maxHeight" | "overflow" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "textTransform" | "textDecoration" | "textOverflow" | "textIndent" | "writingMode" | "whiteSpace" | "wordBreak" | "lineClamp" | "fontVariantNumeric" | "screenReaderOnly" | "color" | "backgroundColor" | "backgroundImage" | "borderStyle" | "borderWidth" | "borderRadius" | "borderColor" | "objectFit" | "objectPosition" | "aspectRatio" | "opacity" | "boxShadow" | "transform" | "transformOrigin" | "transitionProperty" | "transitionDuration" | "transitionTimingFunction" | "animation" | "pointerEvents" | "cursor" | "userSelect" | "fontStyle" | "textUnderlineOffset" | "scrollMarginTop" | "alignSelf" | "flex" | "outlineStyle" | "resize" | "ringWidth" | "ringColor" | "backdropFilter" | "overscrollBehavior" | "divideWidth" | "divideColor";
+export type StyleStateMode = "hover" | "active" | "focus" | "disabled";
+export type StyleBreakpoint = "sm" | "md" | "lg" | "xl" | "2xl";
+/**
+ * 操作请求 —— 由 client 发起，发送至 engine 执行。
+ */
+export interface OperationRequest {
+    /** 请求唯一 ID（用于关联 result / error） */
+    id: string;
+    /** 节点级编辑时可选的 route 约束。 */
+    routeId?: string;
+    /** 操作类型 */
+    kind: OperationType;
+    /** 操作目标。节点级编辑走 node，路由入口编辑走 route。 */
+    target: OperationTarget;
+    /** 请求时的 document version，用于乐观锁冲突检测 */
+    documentVersion: number;
+    /** 操作参数，按 kind 区分 */
+    params: OperationParams;
+}
+/**
+ * 移动/插入目标位置。
+ *
+ * 支持四种 relation:
+ * - before / after: 以 anchorKey 为锚点的前后位置
+ * - prepend / append: 以 parentKey 为容器的首尾位置
+ *
+ * 关键：anchorKey / parentKey 可以跨组件、跨文件，
+ * 展开为多步 RewritePlan 是 engine/planner 的责任。
+ */
+export type MoveTarget = {
+    relation: "before" | "after";
+    anchorKey: string;
+} | {
+    relation: "prepend" | "append";
+    parentKey: string;
+};
+/**
+ * 可插入的 HTML 标签集合。
+ *
+ * 使用 string 联合 + 品牌扩展，允许任意合法 HTML 标签。
+ */
+export type InsertableTag = "div" | "span" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "ul" | "ol" | "li" | "a" | "button" | "img" | "input" | "section" | "article" | "header" | "footer" | "nav" | "main" | "aside" | "form" | "label" | "textarea" | "select" | "option" | "table" | "thead" | "tbody" | "tr" | "th" | "td" | (string & {});
+/**
+ * 插入节点规格。
+ *
+ * 支持两种模式：
+ * - native-tag: 插入 HTML 原生标签（可带文本）
+ * - component-call: 插入组件调用（需要 source + exportName + optional props）
+ *
+ * 关键：不能退化成 native-tag-only，component-call 是正式能力。
+ */
+export type InsertNodeSpec = {
+    kind: "native-tag";
+    tag: InsertableTag;
+    text?: string;
+} | {
+    kind: "component-call";
+    component: {
+        source: string;
+        exportName: string;
+    };
+    props?: Record<string, unknown>;
+};
+/**
+ * 操作参数联合类型 —— 按 kind 区分。
+ *
+ * - update-text: 更新文本段落（segmentIndex + value）
+ * - remove-node: 移除节点（无额外参数）
+ * - insert-child: 插入子节点（node 规格 + position）
+ * - move-node: 移动节点（target 位置 + preserveBindings）
+ */
+export type OperationParams = {
+    kind: "update-text";
+    segmentIndex: number;
+    value: string;
+} | {
+    kind: "remove-node";
+} | {
+    kind: "insert-child";
+    node: InsertNodeSpec;
+    position: MoveTarget;
+} | {
+    kind: "move-node";
+    target: MoveTarget;
+    preserveBindings?: boolean;
+} | {
+    kind: "replace-rich-text-content";
+    field: string;
+    value: OperationValue;
+} | {
+    kind: "insert-rich-text-block";
+    field: string;
+    index: number;
+    block: OperationValue;
+} | {
+    kind: "remove-rich-text-block";
+    field: string;
+    index: number;
+} | {
+    kind: "set-media-field";
+    field: "src" | "alt" | "poster" | "caption" | "width" | "height";
+    value: OperationValue;
+} | {
+    kind: "set-component-slot-content";
+    slotName: string;
+    value: OperationValue;
+} | {
+    kind: "set-object-field";
+    segmentIndex: number;
+    value: OperationValue;
+} | {
+    kind: "insert-object-field";
+    segmentIndex: number;
+    field: string;
+    value: OperationValue;
+} | {
+    kind: "remove-object-field";
+    segmentIndex: number;
+    field?: string;
+} | {
+    kind: "update-array-item";
+    segmentIndex: number;
+    value: OperationValue;
+    index?: number;
+} | {
+    kind: "insert-array-item";
+    segmentIndex: number;
+    index: number;
+    value: OperationValue;
+} | {
+    kind: "remove-array-item";
+    segmentIndex: number;
+    index?: number;
+} | {
+    kind: "move-array-item";
+    segmentIndex: number;
+    toIndex: number;
+    fromIndex?: number;
+} | {
+    kind: "replace-conditional-expression";
+    nextExpression: string;
+} | {
+    kind: "set-conditional-branch-content";
+    branch: "then" | "else";
+    content: {
+        jsx: string;
+    };
+} | {
+    kind: "set-jsx-prop";
+    name: string;
+    value: OperationValue | null;
+} | {
+    kind: "remove-jsx-prop";
+    name: string;
+} | {
+    kind: "set-class-name";
+    value: string;
+} | {
+    kind: "add-class-token";
+    token: string;
+} | {
+    kind: "remove-class-token";
+    token: string;
+} | {
+    kind: "set-style-property";
+    property: string;
+    value: OperationValue | null;
+} | {
+    kind: "set-style-properties";
+    properties: Record<string, OperationValue | null>;
+} | {
+    kind: "set-css-module-class";
+    from: string;
+    to: string;
+} | {
+    kind: "set-directive";
+    value: "use client" | "use server";
+} | {
+    kind: "remove-directive";
+    value: "use client" | "use server";
+} | {
+    kind: "set-route-export";
+    name: string;
+    value: OperationValue;
+} | {
+    kind: "set-metadata-field";
+    field: string;
+    value: OperationValue | null;
+} | {
+    kind: "set-generate-metadata";
+    field: string;
+    value: OperationValue | null;
+};
+/**
+ * 操作结果 —— engine 执行完成后返回。
+ */
+export interface OperationResult {
+    /** 对应的请求 ID */
+    requestId: string;
+    /** 操作类型 */
+    kind: OperationType;
+    /** 操作目标 */
+    target: OperationTarget;
+    /** 是否成功 */
+    ok: boolean;
+    /** 操作后的 document version */
+    resultVersion: number;
+    /** 失败时的错误信息 */
+    error?: OperationError;
+}

package/dist/internal/protocol/operation.js

@@ -0,0 +1,8 @@
+// ─── Operation 契约 ───────────────────────────────────
+// 来源: docs/02-contracts-and-protocol.md §5
+//
+// 关键规则:
+//   MoveTarget 必须允许跨组件 / 跨文件目标表达
+//   InsertNodeSpec 必须允许 component-call
+//   protocol 只表达请求意图，不表达内部 locator 展开方式
+export {};

package/dist/internal/protocol/render.d.ts

@@ -0,0 +1,212 @@
+import type { NodeCapabilitySnapshot } from "./capability.js";
+import type { BoundaryKind } from "./boundary.js";
+import type { OperationType, StyleBreakpoint, StyleProperty, StyleStateMode } from "./operation.js";
+export type ExternalSourceKind = "api-field" | "cms-field" | "i18n-message" | "config-entry";
+export interface ExternalSourceView {
+    sourceType: ExternalSourceKind;
+    sourceId: string;
+    adapterId?: string;
+}
+/**
+ * 轻量级文档树 —— 一个路由对应一棵 RenderDocument。
+ * 由 engine 从 graph 投影而来，client 用于构建大纲 / 画布。
+ */
+export interface RenderDocument {
+    routeId: string;
+    version: number;
+    rootKeys: string[];
+    entries: RenderEntry[];
+}
+/**
+ * 单个渲染条目 —— 描述一个节点在树中的位置与概要能力。
+ */
+export interface RenderEntry {
+    key: string;
+    tag: string;
+    label: string;
+    parentKey: string | null;
+    childKeys: string[];
+    operationSummary: OperationSummary;
+}
+/**
+ * 能力概要 —— 标记该节点支持的四个核心操作。
+ * 用于大纲 / 画布的快速渲染，详细约束见 NodeCapabilitySnapshot。
+ */
+export interface OperationSummary {
+    canUpdateText: boolean;
+    canInsertChild: boolean;
+    canMove: boolean;
+    canRemove: boolean;
+}
+/**
+ * 选中节点的详细信息 —— 按需加载。
+ * 包含完整 capability、text segments、boundary 信息、邻接关系。
+ */
+export interface RenderObjectDetail {
+    key: string;
+    tag: string;
+    componentName: string;
+    sourceFile: string;
+    label: string;
+    capabilities: NodeCapabilitySnapshot;
+    writeTarget: WriteTargetView;
+    effectiveWriteTarget?: EffectiveWriteTargetView;
+    provenanceChain?: ProvenanceChainView;
+    componentSemantic?: ComponentSemanticDescriptor;
+    contentModel?: ContentModelView;
+    mediaModel?: MediaModelView;
+    styleSource?: StyleSourceView;
+    styleModel?: StyleModelView;
+    conditional?: ConditionalDetailView;
+    textSegments: TextSegmentView[];
+    boundaryKind: BoundaryKind | null;
+    isOpaque: boolean;
+    ancestors: RenderEntryRef[];
+    children: RenderEntryRef[];
+    siblings: RenderEntryRef[];
+}
+/**
+ * 写回目标视图 —— 描述该节点的语义写回落点。
+ */
+export interface WriteTargetView {
+    kind: "jsx-node" | "component-proxy" | "value-binding" | "route-export";
+    file: string;
+    componentName: string;
+    isProxy: boolean;
+}
+export interface EffectiveWriteTargetView {
+    kind: "jsx-node" | "value-path" | "route-export" | "external-entry";
+    file?: string;
+    isProxy: boolean;
+    displayPath?: string;
+    sourceType?: ExternalSourceKind;
+    sourceId?: string;
+}
+/**
+ * 文本段落视图 —— 表示一个可编辑 / 只读的文本片段。
+ */
+export interface TextSegmentView {
+    index: number;
+    value: string;
+    editable: boolean;
+    source: TextSourceView | null;
+}
+/**
+ * 文本来源视图 —— 描述文本片段来自字面量、绑定或模板。
+ */
+export interface TextSourceView {
+    kind: "literal" | "binding" | "imported-binding" | "repeat-template";
+    file: string;
+    expression: string;
+    bindingName?: string;
+    path?: Array<string | number>;
+}
+export interface ProvenanceChainView {
+    finalSource: SemanticSourceView | null;
+    chain: ProvenanceHopView[];
+    confidence: "exact" | "safe-derived" | "partial" | "unknown";
+    editMode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
+    diagnostics: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export interface SemanticSourceView {
+    kind: "jsx-literal" | "component-prop" | "binding" | "imported-binding" | "object-field" | "array-item" | "repeat-template" | "conditional-branch" | ExternalSourceKind;
+    file: string;
+    displayPath: string;
+    externalSource?: ExternalSourceView;
+}
+export interface ProvenanceHopView {
+    kind: "jsx-literal" | "component-prop" | "binding" | "imported-binding" | "object-field" | "array-item" | "repeat-template" | "conditional-branch" | ExternalSourceKind;
+    file: string;
+    displayName: string;
+    canEditHere: boolean;
+}
+export interface ComponentSemanticDescriptor {
+    componentName: string;
+    instanceKey: string;
+    templateOwner?: string;
+    variantKeys?: string[];
+    slotKeys?: string[];
+    editableStrategy: "instance" | "template" | "upstream";
+    impactScope?: "current-instance" | "component-template" | "upstream-source";
+    alternativeStrategies?: Array<"instance" | "template" | "upstream">;
+}
+export type ContentModelOperation = Extract<OperationType, "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block">;
+export type MediaModelOperation = Extract<OperationType, "set-media-field">;
+export type StyleModelOperation = Extract<OperationType, "set-style-property" | "set-style-properties">;
+export interface ModelDiagnosticView {
+    code: "unsupported-schema" | "unsupported-field";
+    field?: string;
+    message: string;
+}
+export interface ContentModelView {
+    kind: "markdown" | "rich-text-json";
+    field: string;
+    valuePath?: string;
+    schema?: string;
+    operationBoundary: ContentModelOperation[];
+    diagnostics?: ModelDiagnosticView[];
+}
+export interface MediaModelView {
+    kind: "image" | "video" | "media";
+    sourceType: "asset-id" | "cms-media-field" | "local-file-reference";
+    fields: string[];
+    editableFields: Array<"src" | "alt" | "poster" | "caption" | "width" | "height">;
+    operationBoundary: MediaModelOperation[];
+    valuePaths?: Record<string, string>;
+    diagnostics?: ModelDiagnosticView[];
+}
+export interface StyleModelView {
+    kind: "css-style-model";
+    editable: boolean;
+    operationBoundary: StyleModelOperation[];
+    properties: StylePropertyView[];
+    sourcePath?: string;
+    diagnostics?: Array<{
+        code: "missing-class-name" | "dynamic-binding" | "non-string-binding";
+        message: string;
+    }>;
+}
+export interface StyleSourceView {
+    kind: "class-name-source";
+    className: string;
+    sourceKind: "missing" | "static-attribute" | "static-expression" | "dynamic-expression";
+    editable: boolean;
+    operationBoundary: StyleModelOperation[];
+    sourcePath?: string;
+    diagnostics?: Array<{
+        code: "missing-class-name" | "dynamic-binding" | "non-string-binding";
+        message: string;
+    }>;
+}
+export interface StylePropertyView {
+    property: StyleProperty;
+    value: string | number | boolean | null;
+    resolvedValue?: string | number | boolean | null;
+    breakpoint?: StyleBreakpoint;
+    state?: StyleStateMode;
+    variants?: string[];
+    options?: Array<string | number>;
+    editable: boolean;
+    operationBoundary?: StyleModelOperation[];
+    diagnostics?: Array<{
+        code: "unsupported-value" | "responsive-value";
+        message: string;
+    }>;
+}
+export interface ConditionalDetailView {
+    currentBranch: "then" | "else";
+    availableBranches: Array<"then" | "else">;
+    conditionExpression: string;
+    provenance?: ProvenanceChainView;
+}
+/**
+ * 轻量级条目引用 —— 用于邻接关系列表。
+ */
+export interface RenderEntryRef {
+    key: string;
+    tag: string;
+    label: string;
+}

package/dist/internal/protocol/render.js

@@ -0,0 +1,3 @@
+// ─── Render 契约 ──────────────────────────────────────
+// 来源: docs/02-contracts-and-protocol.md §3
+export {};

package/dist/internal/protocol.d.ts

@@ -0,0 +1,9 @@
+export { computeSourceIdentityKey, parseSourceIdentityKey, } from "./protocol/identity.js";
+export { OperationErrorCode } from "./protocol/error.js";
+export type { BoundaryKind } from "./protocol/boundary.js";
+export type { CapabilityConstraint, CapabilityModeView, ConstraintKind, NodeCapabilitySnapshot, } from "./protocol/capability.js";
+export type { DesignerEvent } from "./protocol/event.js";
+export type { OperationError } from "./protocol/error.js";
+export type { SourceIdentity } from "./protocol/identity.js";
+export type { InsertableTag, InsertNodeSpec, MoveTarget, OperationParams, OperationRequest, OperationResult, OperationTarget, OperationType, OperationValue, StyleBreakpoint, StyleProperty, StyleStateMode, } from "./protocol/operation.js";
+export type { ComponentSemanticDescriptor, ConditionalDetailView, ContentModelView, EffectiveWriteTargetView, MediaModelView, OperationSummary, ProvenanceChainView, ProvenanceHopView, RenderDocument, RenderEntry, RenderEntryRef, RenderObjectDetail, SemanticSourceView, StyleModelOperation, StyleModelView, StyleSourceView, StylePropertyView, TextSegmentView, TextSourceView, WriteTargetView, } from "./protocol/render.js";

package/dist/internal/protocol.js

@@ -0,0 +1,2 @@
+export { computeSourceIdentityKey, parseSourceIdentityKey, } from "./protocol/identity.js";
+export { OperationErrorCode } from "./protocol/error.js";

package/dist/internal/provenance/binding-graph.d.ts

@@ -0,0 +1,39 @@
+import type { Binding, NodePath } from "@babel/traverse";
+import * as t from "@babel/types";
+import type { TextExpressionSource } from "../graph/types.js";
+import type { ValuePathSegment } from "../ast/types.js";
+export type BindingGraphNodeKind = "literal" | "local-binding" | "param" | "prop-default" | "alias" | "imported-binding" | "hook-state" | "async-result";
+export type BindingGraphEdgeKind = "assigned-from" | "destructured-from" | "defaulted-from" | "passed-prop" | "imported-from" | "setter-updated-by";
+export interface BindingGraphNode {
+    id: string;
+    kind: BindingGraphNodeKind;
+    name: string;
+    path: NodePath;
+}
+export interface BindingGraphEdge {
+    from: string;
+    to: string;
+    kind: BindingGraphEdgeKind;
+}
+export interface BindingGraph {
+    nodes: BindingGraphNode[];
+    edges: BindingGraphEdge[];
+}
+export interface PropDefaultBinding {
+    propName: string;
+    componentName: string;
+    expressionPath: NodePath<t.Expression>;
+    displayPath: string;
+}
+export interface ParamPropReference {
+    propName: string;
+    remainingPath: ValuePathSegment[];
+}
+export interface AliasInitializer {
+    expressionPath: NodePath<t.Expression>;
+}
+export declare function createBindingGraph(): BindingGraph;
+export declare function findAliasInitializer(binding: Binding): AliasInitializer | null;
+export declare function getParamPropReference(binding: Binding, sourceInfo?: TextExpressionSource): ParamPropReference | null;
+export declare function findPropDefaultBinding(binding: Binding, componentName: string, expectedPropName?: string): PropDefaultBinding | null;
+export declare function findPatternBindingPath(pattern: t.PatternLike, bindingName: string, prefix?: ValuePathSegment[]): ValuePathSegment[] | null;

package/dist/internal/provenance/binding-graph.js

@@ -0,0 +1,184 @@
+import * as t from "@babel/types";
+export function createBindingGraph() {
+    return { nodes: [], edges: [] };
+}
+export function findAliasInitializer(binding) {
+    if (binding.path.isVariableDeclarator()) {
+        const initPath = binding.path.get("init");
+        return initPath?.isExpression() ? { expressionPath: initPath } : null;
+    }
+    if (!binding.path.isIdentifier() ||
+        !binding.path.parentPath?.isVariableDeclarator()) {
+        return null;
+    }
+    const initPath = binding.path.parentPath.get("init");
+    if (!initPath?.isExpression()) {
+        return null;
+    }
+    return { expressionPath: initPath };
+}
+export function getParamPropReference(binding, sourceInfo) {
+    if (binding.path.isObjectPattern()) {
+        return sourceInfo
+            ? {
+                propName: sourceInfo.base,
+                remainingPath: sourceInfo.path,
+            }
+            : null;
+    }
+    const objectProperty = getDestructuredPropPropertyPath(binding);
+    if (objectProperty) {
+        const propName = getObjectPropertyKey(objectProperty.node);
+        if (!propName) {
+            return null;
+        }
+        return {
+            propName,
+            remainingPath: sourceInfo?.path ?? [],
+        };
+    }
+    if (binding.path.isIdentifier() &&
+        binding.path.key === 0 &&
+        Array.isArray(binding.path.container)) {
+        const [firstPath, ...restPath] = sourceInfo?.path ?? [];
+        if (!firstPath || firstPath.kind !== "property") {
+            return null;
+        }
+        return {
+            propName: firstPath.name,
+            remainingPath: restPath,
+        };
+    }
+    return null;
+}
+export function findPropDefaultBinding(binding, componentName, expectedPropName) {
+    if (binding.path.isObjectPattern()) {
+        for (const property of binding.path.get("properties")) {
+            if (!property.isObjectProperty()) {
+                continue;
+            }
+            const propName = getObjectPropertyKey(property.node);
+            if (!propName || (expectedPropName && propName !== expectedPropName)) {
+                continue;
+            }
+            const valuePath = property.get("value");
+            if (!valuePath.isAssignmentPattern()) {
+                continue;
+            }
+            const rightPath = valuePath.get("right");
+            if (!rightPath.isExpression()) {
+                continue;
+            }
+            return {
+                propName,
+                componentName,
+                expressionPath: rightPath,
+                displayPath: `${componentName}.${propName}.default`,
+            };
+        }
+    }
+    const assignmentPath = getDefaultAssignmentPath(binding);
+    if (!assignmentPath) {
+        return null;
+    }
+    const objectProperty = assignmentPath.parentPath;
+    if (!objectProperty?.isObjectProperty()) {
+        return null;
+    }
+    const propName = getObjectPropertyKey(objectProperty.node);
+    if (!propName || (expectedPropName && propName !== expectedPropName)) {
+        return null;
+    }
+    const rightPath = assignmentPath.get("right");
+    if (!rightPath.isExpression()) {
+        return null;
+    }
+    return {
+        propName,
+        componentName,
+        expressionPath: rightPath,
+        displayPath: `${componentName}.${propName}.default`,
+    };
+}
+export function findPatternBindingPath(pattern, bindingName, prefix = []) {
+    if (t.isIdentifier(pattern)) {
+        return pattern.name === bindingName ? prefix : null;
+    }
+    if (t.isObjectPattern(pattern)) {
+        for (const property of pattern.properties) {
+            if (t.isObjectProperty(property)) {
+                const key = getObjectPropertyKey(property);
+                if (!key) {
+                    continue;
+                }
+                const result = findPatternBindingPath(property.value, bindingName, [...prefix, { kind: "property", name: key }]);
+                if (result) {
+                    return result;
+                }
+            }
+            else if (t.isRestElement(property)) {
+                const result = findPatternBindingPath(property.argument, bindingName, prefix);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+    }
+    if (t.isArrayPattern(pattern)) {
+        for (let index = 0; index < pattern.elements.length; index += 1) {
+            const element = pattern.elements[index];
+            if (!element) {
+                continue;
+            }
+            const target = t.isRestElement(element) ? element.argument : element;
+            const result = findPatternBindingPath(target, bindingName, [...prefix, { kind: "index", index }]);
+            if (result) {
+                return result;
+            }
+        }
+    }
+    if (t.isAssignmentPattern(pattern)) {
+        return findPatternBindingPath(pattern.left, bindingName, prefix);
+    }
+    return null;
+}
+function getDefaultAssignmentPath(binding) {
+    if (!binding.path.isIdentifier()) {
+        return null;
+    }
+    const parent = binding.path.parentPath;
+    if (parent?.isAssignmentPattern() && parent.node.left === binding.path.node) {
+        return parent;
+    }
+    return null;
+}
+function getDestructuredPropPropertyPath(binding) {
+    if (!binding.path.isIdentifier()) {
+        return null;
+    }
+    const directParent = binding.path.parentPath;
+    if (directParent?.isObjectProperty() &&
+        directParent.parentPath?.isObjectPattern()) {
+        return directParent;
+    }
+    const assignmentParent = directParent?.isAssignmentPattern()
+        ? directParent.parentPath
+        : null;
+    if (assignmentParent?.isObjectProperty() &&
+        assignmentParent.parentPath?.isObjectPattern()) {
+        return assignmentParent;
+    }
+    return null;
+}
+function getObjectPropertyKey(property) {
+    if (property.computed) {
+        return null;
+    }
+    if (t.isIdentifier(property.key)) {
+        return property.key.name;
+    }
+    if (t.isStringLiteral(property.key)) {
+        return property.key.value;
+    }
+    return null;
+}