@agent-native/core 0.92.11 → 0.93.0

package/corpus/templates/design/app/i18n-template-feature.ts

@@ -0,0 +1,458 @@
+export const designTemplateFeatureOverrides = {
+  "zh-TW": {
+    designEditor: {
+      saveAsTemplate: "儲存為範本…",
+      saveTemplateDescription:
+        "將目前畫面、尺寸、預設值與鎖定圖層擷取為可重複使用的起點。",
+      templateName: "範本名稱",
+      templateDescription: "說明",
+      templateCategory: "類別",
+      templateSnapshotSummary:
+        "將保留 {{screens}} 個畫面 · {{locks}} 個鎖定圖層",
+      saveTemplate: "儲存範本",
+      templateSaved: "已儲存範本，包含 {{count}} 個鎖定圖層",
+      templateSaveFailed: "無法儲存此範本",
+    },
+    templatesPage: {
+      title: "範本",
+      description: "從正確的尺寸與預設值開始，再用提示調整未鎖定的內容。",
+      searchPlaceholder: "搜尋範本...",
+      starterTemplates: "入門範本",
+      savedTemplates: "已儲存的範本",
+      savedTemplatesDescription:
+        "從編輯器選單將任何 Design 專案儲存為可重複使用的範本。",
+      savedEmpty: "開啟設計並選擇「儲存為範本」，即可新增到這裡。",
+      useAsIs: "直接使用範本",
+      promptPlaceholder: "描述您想用此範本製作的內容...",
+      opening: "正在開啟範本...",
+      createFailed: "無法從此範本建立設計",
+      deleted: "範本已刪除",
+      deleteFailed: "無法刪除此範本",
+      deleteTitle: "刪除範本？",
+      deleteDescription:
+        "這會永久刪除 {{title}}。已從此範本建立的設計不受影響。",
+      templateActions: "範本操作",
+      lockedCount: "已鎖定 {{count}} 個",
+      categories: {
+        ad: "廣告",
+        social: "社群",
+        "one-pager": "單頁文件",
+        "landing-page": "到達頁面",
+        presentation: "簡報",
+        other: "其他",
+      },
+    },
+  },
+  "zh-CN": {
+    designEditor: {
+      saveAsTemplate: "保存为模板…",
+      saveTemplateDescription:
+        "将当前屏幕、尺寸、默认值和锁定图层保存为可重复使用的起点。",
+      templateName: "模板名称",
+      templateDescription: "描述",
+      templateCategory: "类别",
+      templateSnapshotSummary:
+        "将保留 {{screens}} 个屏幕 · {{locks}} 个锁定图层",
+      saveTemplate: "保存模板",
+      templateSaved: "模板已保存，包含 {{count}} 个锁定图层",
+      templateSaveFailed: "无法保存此模板",
+    },
+    templatesPage: {
+      title: "模板",
+      description: "从正确的尺寸和默认值开始，再用提示调整未锁定的内容。",
+      searchPlaceholder: "搜索模板...",
+      starterTemplates: "入门模板",
+      savedTemplates: "已保存的模板",
+      savedTemplatesDescription:
+        "从编辑器菜单将任意 Design 项目保存为可重复使用的模板。",
+      savedEmpty: "打开设计并选择“保存为模板”即可添加到此处。",
+      useAsIs: "直接使用模板",
+      promptPlaceholder: "描述您想使用此模板制作的内容...",
+      opening: "正在打开模板...",
+      createFailed: "无法从此模板创建设计",
+      deleted: "模板已删除",
+      deleteFailed: "无法删除此模板",
+      deleteTitle: "删除模板？",
+      deleteDescription:
+        "这将永久删除 {{title}}。已从此模板创建的设计不受影响。",
+      templateActions: "模板操作",
+      lockedCount: "已锁定 {{count}} 个",
+      categories: {
+        ad: "广告",
+        social: "社交",
+        "one-pager": "单页文档",
+        "landing-page": "着陆页",
+        presentation: "演示文稿",
+        other: "其他",
+      },
+    },
+  },
+  "es-ES": {
+    designEditor: {
+      saveAsTemplate: "Guardar como plantilla…",
+      saveTemplateDescription:
+        "Captura las pantallas, dimensiones, valores predeterminados y capas bloqueadas como punto de partida reutilizable.",
+      templateName: "Nombre de la plantilla",
+      templateDescription: "Descripción",
+      templateCategory: "Categoría",
+      templateSnapshotSummary:
+        "Se conservarán {{screens}} pantalla(s) · {{locks}} capa(s) bloqueada(s)",
+      saveTemplate: "Guardar plantilla",
+      templateSaved: "Plantilla guardada con {{count}} capa(s) bloqueada(s)",
+      templateSaveFailed: "No se pudo guardar esta plantilla",
+    },
+    templatesPage: {
+      title: "Plantillas",
+      description:
+        "Empieza con las dimensiones y valores correctos y ajusta con indicaciones el contenido desbloqueado.",
+      searchPlaceholder: "Buscar plantillas...",
+      starterTemplates: "Plantillas iniciales",
+      savedTemplates: "Plantillas guardadas",
+      savedTemplatesDescription:
+        "Guarda cualquier proyecto de Design como plantilla reutilizable desde el menú del editor.",
+      savedEmpty:
+        "Abre un diseño y elige Guardar como plantilla para añadirlo aquí.",
+      useAsIs: "Usar la plantilla tal cual",
+      promptPlaceholder: "Describe lo que quieres crear con esta plantilla...",
+      opening: "Abriendo plantilla...",
+      createFailed: "No se pudo crear un diseño desde esta plantilla",
+      deleted: "Plantilla eliminada",
+      deleteFailed: "No se pudo eliminar esta plantilla",
+      deleteTitle: "¿Eliminar plantilla?",
+      deleteDescription:
+        "Esto elimina permanentemente {{title}}. Los diseños ya creados no se verán afectados.",
+      templateActions: "Acciones de plantilla",
+      lockedCount: "{{count}} bloqueadas",
+      categories: {
+        ad: "Anuncio",
+        social: "Redes sociales",
+        "one-pager": "Documento de una página",
+        "landing-page": "Página de destino",
+        presentation: "Presentación",
+        other: "Otro",
+      },
+    },
+  },
+  "fr-FR": {
+    designEditor: {
+      saveAsTemplate: "Enregistrer comme modèle…",
+      saveTemplateDescription:
+        "Capturez les écrans, dimensions, valeurs par défaut et calques verrouillés comme point de départ réutilisable.",
+      templateName: "Nom du modèle",
+      templateDescription: "Description",
+      templateCategory: "Catégorie",
+      templateSnapshotSummary:
+        "{{screens}} écran(s) · {{locks}} calque(s) verrouillé(s) seront conservés",
+      saveTemplate: "Enregistrer le modèle",
+      templateSaved: "Modèle enregistré avec {{count}} calque(s) verrouillé(s)",
+      templateSaveFailed: "Impossible d’enregistrer ce modèle",
+    },
+    templatesPage: {
+      title: "Modèles",
+      description:
+        "Commencez avec les bonnes dimensions et valeurs, puis adaptez le contenu déverrouillé par invite.",
+      searchPlaceholder: "Rechercher des modèles...",
+      starterTemplates: "Modèles de départ",
+      savedTemplates: "Modèles enregistrés",
+      savedTemplatesDescription:
+        "Enregistrez tout projet Design comme modèle réutilisable depuis le menu de l’éditeur.",
+      savedEmpty:
+        "Ouvrez un design et choisissez Enregistrer comme modèle pour l’ajouter ici.",
+      useAsIs: "Utiliser le modèle tel quel",
+      promptPlaceholder:
+        "Décrivez ce que vous souhaitez créer avec ce modèle...",
+      opening: "Ouverture du modèle...",
+      createFailed: "Impossible de créer un design à partir de ce modèle",
+      deleted: "Modèle supprimé",
+      deleteFailed: "Impossible de supprimer ce modèle",
+      deleteTitle: "Supprimer le modèle ?",
+      deleteDescription:
+        "Cela supprime définitivement {{title}}. Les designs déjà créés ne sont pas affectés.",
+      templateActions: "Actions du modèle",
+      lockedCount: "{{count}} verrouillés",
+      categories: {
+        ad: "Publicité",
+        social: "Réseaux sociaux",
+        "one-pager": "Document d’une page",
+        "landing-page": "Page d’atterrissage",
+        presentation: "Présentation",
+        other: "Autre",
+      },
+    },
+  },
+  "de-DE": {
+    designEditor: {
+      saveAsTemplate: "Als Vorlage speichern…",
+      saveTemplateDescription:
+        "Aktuelle Screens, Abmessungen, Standardwerte und gesperrte Ebenen als wiederverwendbaren Ausgangspunkt sichern.",
+      templateName: "Vorlagenname",
+      templateDescription: "Beschreibung",
+      templateCategory: "Kategorie",
+      templateSnapshotSummary:
+        "{{screens}} Screen(s) · {{locks}} gesperrte Ebene(n) werden beibehalten",
+      saveTemplate: "Vorlage speichern",
+      templateSaved: "Vorlage mit {{count}} gesperrten Ebene(n) gespeichert",
+      templateSaveFailed: "Diese Vorlage konnte nicht gespeichert werden",
+    },
+    templatesPage: {
+      title: "Vorlagen",
+      description:
+        "Mit passenden Abmessungen und Standardwerten starten und entsperrte Inhalte per Prompt anpassen.",
+      searchPlaceholder: "Vorlagen suchen...",
+      starterTemplates: "Startvorlagen",
+      savedTemplates: "Gespeicherte Vorlagen",
+      savedTemplatesDescription:
+        "Jedes Design-Projekt über das Editormenü als wiederverwendbare Vorlage speichern.",
+      savedEmpty:
+        "Öffne ein Design und wähle Als Vorlage speichern, um es hier hinzuzufügen.",
+      useAsIs: "Vorlage unverändert verwenden",
+      promptPlaceholder:
+        "Beschreibe, was du mit dieser Vorlage erstellen möchtest...",
+      opening: "Vorlage wird geöffnet...",
+      createFailed: "Aus dieser Vorlage konnte kein Design erstellt werden",
+      deleted: "Vorlage gelöscht",
+      deleteFailed: "Diese Vorlage konnte nicht gelöscht werden",
+      deleteTitle: "Vorlage löschen?",
+      deleteDescription:
+        "Dadurch wird {{title}} dauerhaft gelöscht. Bereits erstellte Designs bleiben erhalten.",
+      templateActions: "Vorlagenaktionen",
+      lockedCount: "{{count}} gesperrt",
+      categories: {
+        ad: "Anzeige",
+        social: "Social Media",
+        "one-pager": "Einseiter",
+        "landing-page": "Landingpage",
+        presentation: "Präsentation",
+        other: "Andere",
+      },
+    },
+  },
+  "ja-JP": {
+    designEditor: {
+      saveAsTemplate: "テンプレートとして保存…",
+      saveTemplateDescription:
+        "現在の画面、寸法、既定値、ロックされたレイヤーを再利用可能な開始点として保存します。",
+      templateName: "テンプレート名",
+      templateDescription: "説明",
+      templateCategory: "カテゴリー",
+      templateSnapshotSummary:
+        "{{screens}} 画面 · {{locks}} 個のロックされたレイヤーを保持します",
+      saveTemplate: "テンプレートを保存",
+      templateSaved:
+        "{{count}} 個のロックされたレイヤーを含むテンプレートを保存しました",
+      templateSaveFailed: "このテンプレートを保存できませんでした",
+    },
+    templatesPage: {
+      title: "テンプレート",
+      description:
+        "適切な寸法と既定値から始め、ロックされていない内容をプロンプトで調整します。",
+      searchPlaceholder: "テンプレートを検索...",
+      starterTemplates: "スターターテンプレート",
+      savedTemplates: "保存済みテンプレート",
+      savedTemplatesDescription:
+        "エディターメニューから任意の Design プロジェクトを再利用可能なテンプレートとして保存できます。",
+      savedEmpty:
+        "デザインを開き、「テンプレートとして保存」を選ぶとここに追加されます。",
+      useAsIs: "そのまま使用",
+      promptPlaceholder: "このテンプレートで作りたいものを説明してください...",
+      opening: "テンプレートを開いています...",
+      createFailed: "このテンプレートからデザインを作成できませんでした",
+      deleted: "テンプレートを削除しました",
+      deleteFailed: "このテンプレートを削除できませんでした",
+      deleteTitle: "テンプレートを削除しますか？",
+      deleteDescription:
+        "{{title}} を完全に削除します。すでに作成済みのデザインには影響しません。",
+      templateActions: "テンプレート操作",
+      lockedCount: "{{count}} 個をロック",
+      categories: {
+        ad: "広告",
+        social: "ソーシャル",
+        "one-pager": "1 ページ資料",
+        "landing-page": "ランディングページ",
+        presentation: "プレゼンテーション",
+        other: "その他",
+      },
+    },
+  },
+  "ko-KR": {
+    designEditor: {
+      saveAsTemplate: "템플릿으로 저장…",
+      saveTemplateDescription:
+        "현재 화면, 크기, 기본값과 잠긴 레이어를 재사용 가능한 시작점으로 저장합니다.",
+      templateName: "템플릿 이름",
+      templateDescription: "설명",
+      templateCategory: "카테고리",
+      templateSnapshotSummary:
+        "화면 {{screens}}개 · 잠긴 레이어 {{locks}}개가 유지됩니다",
+      saveTemplate: "템플릿 저장",
+      templateSaved: "잠긴 레이어 {{count}}개와 함께 템플릿을 저장했습니다",
+      templateSaveFailed: "이 템플릿을 저장할 수 없습니다",
+    },
+    templatesPage: {
+      title: "템플릿",
+      description:
+        "알맞은 크기와 기본값으로 시작한 뒤 잠기지 않은 내용을 프롬프트로 조정하세요.",
+      searchPlaceholder: "템플릿 검색...",
+      starterTemplates: "시작 템플릿",
+      savedTemplates: "저장된 템플릿",
+      savedTemplatesDescription:
+        "편집기 메뉴에서 모든 Design 프로젝트를 재사용 가능한 템플릿으로 저장할 수 있습니다.",
+      savedEmpty: "디자인을 열고 템플릿으로 저장을 선택하면 여기에 추가됩니다.",
+      useAsIs: "템플릿 그대로 사용",
+      promptPlaceholder: "이 템플릿으로 만들고 싶은 내용을 설명하세요...",
+      opening: "템플릿 여는 중...",
+      createFailed: "이 템플릿에서 디자인을 만들 수 없습니다",
+      deleted: "템플릿이 삭제되었습니다",
+      deleteFailed: "이 템플릿을 삭제할 수 없습니다",
+      deleteTitle: "템플릿을 삭제할까요?",
+      deleteDescription:
+        "{{title}}을(를) 영구 삭제합니다. 이미 만든 디자인에는 영향을 주지 않습니다.",
+      templateActions: "템플릿 작업",
+      lockedCount: "{{count}}개 잠김",
+      categories: {
+        ad: "광고",
+        social: "소셜",
+        "one-pager": "원페이지",
+        "landing-page": "랜딩 페이지",
+        presentation: "프레젠테이션",
+        other: "기타",
+      },
+    },
+  },
+  "pt-BR": {
+    designEditor: {
+      saveAsTemplate: "Salvar como modelo…",
+      saveTemplateDescription:
+        "Capture as telas, dimensões, padrões e camadas bloqueadas como um ponto de partida reutilizável.",
+      templateName: "Nome do modelo",
+      templateDescription: "Descrição",
+      templateCategory: "Categoria",
+      templateSnapshotSummary:
+        "{{screens}} tela(s) · {{locks}} camada(s) bloqueada(s) serão preservadas",
+      saveTemplate: "Salvar modelo",
+      templateSaved: "Modelo salvo com {{count}} camada(s) bloqueada(s)",
+      templateSaveFailed: "Não foi possível salvar este modelo",
+    },
+    templatesPage: {
+      title: "Modelos",
+      description:
+        "Comece com as dimensões e padrões certos e ajuste o conteúdo desbloqueado por prompt.",
+      searchPlaceholder: "Buscar modelos...",
+      starterTemplates: "Modelos iniciais",
+      savedTemplates: "Modelos salvos",
+      savedTemplatesDescription:
+        "Salve qualquer projeto do Design como um modelo reutilizável no menu do editor.",
+      savedEmpty:
+        "Abra um design e escolha Salvar como modelo para adicioná-lo aqui.",
+      useAsIs: "Usar o modelo como está",
+      promptPlaceholder: "Descreva o que você quer criar com este modelo...",
+      opening: "Abrindo modelo...",
+      createFailed: "Não foi possível criar um design com este modelo",
+      deleted: "Modelo excluído",
+      deleteFailed: "Não foi possível excluir este modelo",
+      deleteTitle: "Excluir modelo?",
+      deleteDescription:
+        "Isso exclui {{title}} permanentemente. Designs já criados não serão afetados.",
+      templateActions: "Ações do modelo",
+      lockedCount: "{{count}} bloqueadas",
+      categories: {
+        ad: "Anúncio",
+        social: "Social",
+        "one-pager": "Página única",
+        "landing-page": "Página de destino",
+        presentation: "Apresentação",
+        other: "Outro",
+      },
+    },
+  },
+  "hi-IN": {
+    designEditor: {
+      saveAsTemplate: "टेम्पलेट के रूप में सहेजें…",
+      saveTemplateDescription:
+        "मौजूदा स्क्रीन, आकार, डिफ़ॉल्ट और लॉक की गई लेयर को दोबारा उपयोग होने वाले शुरुआती बिंदु के रूप में सहेजें।",
+      templateName: "टेम्पलेट का नाम",
+      templateDescription: "विवरण",
+      templateCategory: "श्रेणी",
+      templateSnapshotSummary:
+        "{{screens}} स्क्रीन · {{locks}} लॉक लेयर सुरक्षित रहेंगी",
+      saveTemplate: "टेम्पलेट सहेजें",
+      templateSaved: "{{count}} लॉक लेयर के साथ टेम्पलेट सहेजा गया",
+      templateSaveFailed: "यह टेम्पलेट सहेजा नहीं जा सका",
+    },
+    templatesPage: {
+      title: "टेम्पलेट",
+      description:
+        "सही आकार और डिफ़ॉल्ट से शुरू करें, फिर अनलॉक सामग्री को प्रॉम्प्ट से बदलें।",
+      searchPlaceholder: "टेम्पलेट खोजें...",
+      starterTemplates: "शुरुआती टेम्पलेट",
+      savedTemplates: "सहेजे गए टेम्पलेट",
+      savedTemplatesDescription:
+        "एडिटर मेनू से किसी भी Design प्रोजेक्ट को दोबारा उपयोग होने वाले टेम्पलेट के रूप में सहेजें।",
+      savedEmpty: "डिज़ाइन खोलें और यहाँ जोड़ने के लिए टेम्पलेट के रूप में सहेजें चुनें।",
+      useAsIs: "टेम्पलेट जैसा है वैसा उपयोग करें",
+      promptPlaceholder: "बताएँ कि इस टेम्पलेट से क्या बनाना चाहते हैं...",
+      opening: "टेम्पलेट खुल रहा है...",
+      createFailed: "इस टेम्पलेट से डिज़ाइन नहीं बनाया जा सका",
+      deleted: "टेम्पलेट हटा दिया गया",
+      deleteFailed: "यह टेम्पलेट हटाया नहीं जा सका",
+      deleteTitle: "टेम्पलेट हटाएँ?",
+      deleteDescription:
+        "यह {{title}} को स्थायी रूप से हटाता है। पहले से बने डिज़ाइन प्रभावित नहीं होंगे।",
+      templateActions: "टेम्पलेट कार्रवाइयाँ",
+      lockedCount: "{{count}} लॉक",
+      categories: {
+        ad: "विज्ञापन",
+        social: "सोशल",
+        "one-pager": "एक-पेज दस्तावेज़",
+        "landing-page": "लैंडिंग पेज",
+        presentation: "प्रस्तुति",
+        other: "अन्य",
+      },
+    },
+  },
+  "ar-SA": {
+    designEditor: {
+      saveAsTemplate: "حفظ كقالب…",
+      saveTemplateDescription:
+        "احفظ الشاشات والأبعاد والإعدادات الافتراضية والطبقات المقفلة كنقطة بداية قابلة لإعادة الاستخدام.",
+      templateName: "اسم القالب",
+      templateDescription: "الوصف",
+      templateCategory: "الفئة",
+      templateSnapshotSummary:
+        "سيتم الاحتفاظ بـ {{screens}} شاشة و{{locks}} طبقة مقفلة",
+      saveTemplate: "حفظ القالب",
+      templateSaved: "تم حفظ القالب مع {{count}} طبقة مقفلة",
+      templateSaveFailed: "تعذر حفظ هذا القالب",
+    },
+    templatesPage: {
+      title: "القوالب",
+      description:
+        "ابدأ بالأبعاد والإعدادات الصحيحة، ثم عدّل المحتوى غير المقفل باستخدام مطالبة.",
+      searchPlaceholder: "البحث في القوالب...",
+      starterTemplates: "قوالب البداية",
+      savedTemplates: "القوالب المحفوظة",
+      savedTemplatesDescription:
+        "احفظ أي مشروع Design كقالب قابل لإعادة الاستخدام من قائمة المحرر.",
+      savedEmpty: "افتح تصميمًا واختر حفظ كقالب لإضافته هنا.",
+      useAsIs: "استخدام القالب كما هو",
+      promptPlaceholder: "صف ما تريد إنشاءه باستخدام هذا القالب...",
+      opening: "جارٍ فتح القالب...",
+      createFailed: "تعذر إنشاء تصميم من هذا القالب",
+      deleted: "تم حذف القالب",
+      deleteFailed: "تعذر حذف هذا القالب",
+      deleteTitle: "حذف القالب؟",
+      deleteDescription:
+        "سيؤدي هذا إلى حذف {{title}} نهائيًا. لن تتأثر التصاميم التي تم إنشاؤها بالفعل.",
+      templateActions: "إجراءات القالب",
+      lockedCount: "{{count}} مقفلة",
+      categories: {
+        ad: "إعلان",
+        social: "اجتماعي",
+        "one-pager": "مستند من صفحة واحدة",
+        "landing-page": "صفحة هبوط",
+        presentation: "عرض تقديمي",
+        other: "أخرى",
+      },
+    },
+  },
+} as const;

package/corpus/templates/design/app/lib/design-clipboard.ts

@@ -0,0 +1,202 @@
+import {
+  type DesignClipboardPayload,
+  parseDesignClipboardMarker,
+} from "./design-import";
+
+interface ClipboardItemLike {
+  types: readonly string[];
+  getType(type: string): Promise<Blob>;
+}
+
+interface ClipboardLike {
+  read?: () => Promise<ClipboardItemLike[]>;
+  readText?: () => Promise<string>;
+  write?: (items: ClipboardItem[]) => Promise<void>;
+  writeText?: (text: string) => Promise<void>;
+}
+
+interface ClipboardItemConstructor {
+  new (items: Record<string, Blob>): ClipboardItem;
+  supports?: (type: string) => boolean;
+}
+
+export interface DesignClipboardEnvironment {
+  clipboard?: ClipboardLike | null;
+  ClipboardItem?: ClipboardItemConstructor | null;
+  legacyCopy?: (representations: DesignClipboardRepresentations) => boolean;
+}
+
+export interface DesignClipboardRepresentations {
+  plainText: string;
+  html: string;
+}
+
+export interface ReadDesignClipboardPayload {
+  payload: DesignClipboardPayload;
+  markerText: string;
+  plainText: string;
+}
+
+function browserClipboardEnvironment(): DesignClipboardEnvironment {
+  return {
+    clipboard:
+      typeof navigator === "undefined" ? null : (navigator.clipboard ?? null),
+    ClipboardItem:
+      typeof globalThis.ClipboardItem === "undefined"
+        ? null
+        : globalThis.ClipboardItem,
+    legacyCopy:
+      typeof document === "undefined" ||
+      typeof document.execCommand !== "function"
+        ? undefined
+        : (representations) => {
+            let wroteRepresentations = false;
+            const handleCopy = (event: ClipboardEvent) => {
+              if (!event.clipboardData) return;
+              event.clipboardData.setData(
+                "text/plain",
+                representations.plainText,
+              );
+              event.clipboardData.setData("text/html", representations.html);
+              event.preventDefault();
+              wroteRepresentations = true;
+            };
+            document.addEventListener("copy", handleCopy, {
+              capture: true,
+              once: true,
+            });
+            try {
+              // The synchronous copy-event path remains available in browsers
+              // that deny the async Clipboard API. It preserves Design's rich
+              // marker across files/tabs without leaking that marker into the
+              // human-readable text/plain representation.
+              return document.execCommand("copy") && wroteRepresentations;
+            } finally {
+              document.removeEventListener("copy", handleCopy, true);
+            }
+          },
+  };
+}
+
+function supportsClipboardType(
+  ClipboardItemCtor: ClipboardItemConstructor,
+  type: string,
+): boolean {
+  return (
+    typeof ClipboardItemCtor.supports !== "function" ||
+    ClipboardItemCtor.supports(type)
+  );
+}
+
+/**
+ * Writes the user-facing text as text/plain and keeps Design's lossless layer
+ * payload in text/html. Apps that only want text therefore receive readable
+ * content, while another Design tab can still reconstruct the copied layers.
+ */
+export async function writeDesignClipboard(
+  representations: DesignClipboardRepresentations,
+  environment: DesignClipboardEnvironment = browserClipboardEnvironment(),
+): Promise<void> {
+  const clipboard = environment.clipboard;
+  const ClipboardItemCtor = environment.ClipboardItem;
+  let richWriteError: unknown;
+
+  if (
+    clipboard?.write &&
+    ClipboardItemCtor &&
+    supportsClipboardType(ClipboardItemCtor, "text/plain") &&
+    supportsClipboardType(ClipboardItemCtor, "text/html")
+  ) {
+    try {
+      await clipboard.write([
+        new ClipboardItemCtor({
+          "text/plain": new Blob([representations.plainText], {
+            type: "text/plain",
+          }),
+          "text/html": new Blob([representations.html], {
+            type: "text/html",
+          }),
+        }),
+      ]);
+      return;
+    } catch (error) {
+      richWriteError = error;
+    }
+  }
+
+  if (environment.legacyCopy?.(representations)) return;
+
+  if (!clipboard?.writeText) {
+    if (richWriteError) throw richWriteError;
+    throw new Error("Clipboard writing is not supported");
+  }
+  await clipboard.writeText(representations.plainText);
+}
+
+export function readDesignClipboardPayloadFromDataTransfer(
+  clipboardData: Pick<DataTransfer, "getData"> | null | undefined,
+): ReadDesignClipboardPayload | null {
+  if (!clipboardData) return null;
+  const plainText = clipboardData.getData("text/plain") ?? "";
+  for (const markerText of [
+    clipboardData.getData("text/html") ?? "",
+    plainText,
+  ]) {
+    const payload = parseDesignClipboardMarker(markerText);
+    if (payload) return { payload, markerText, plainText };
+  }
+  return null;
+}
+
+export async function readDesignClipboardPayloadFromSystem(
+  environment: DesignClipboardEnvironment = browserClipboardEnvironment(),
+): Promise<ReadDesignClipboardPayload | null> {
+  const clipboard = environment.clipboard;
+  if (!clipboard) return null;
+
+  if (clipboard.read) {
+    try {
+      const items = await clipboard.read();
+      for (const item of items) {
+        const plainText = item.types.includes("text/plain")
+          ? await (await item.getType("text/plain")).text()
+          : "";
+        for (const type of ["text/html", "text/plain"]) {
+          if (!item.types.includes(type)) continue;
+          const markerText = await (await item.getType(type)).text();
+          const payload = parseDesignClipboardMarker(markerText);
+          if (payload) return { payload, markerText, plainText };
+        }
+      }
+    } catch {
+      // Fall back to readText below. It also understands clipboards written by
+      // older Design versions that stored the marker in text/plain.
+    }
+  }
+
+  if (!clipboard.readText) return null;
+  try {
+    const markerText = await clipboard.readText();
+    const payload = parseDesignClipboardMarker(markerText);
+    return payload ? { payload, markerText, plainText: markerText } : null;
+  } catch {
+    return null;
+  }
+}
+
+export function plainTextFromDesignHtml(htmlFragments: string[]): string {
+  return htmlFragments
+    .map((html) => {
+      const doc = new DOMParser().parseFromString(html, "text/html");
+      doc
+        .querySelectorAll("script, style, template, noscript")
+        .forEach((node) => node.remove());
+      return (doc.body.innerText || doc.body.textContent || "")
+        .replace(/\u00a0/g, " ")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    })
+    .filter(Boolean)
+    .join("\n");
+}