@tiptap/extension-twitch 3.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Tiptap GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# @tiptap/extension-twitch
+
+[![Version](https://img.shields.io/npm/v/@tiptap/extension-twitch.svg?label=version)](https://www.npmjs.com/package/@tiptap/extension-twitch)
+[![Downloads](https://img.shields.io/npm/dm/@tiptap/extension-twitch.svg)](https://npmcharts.com/compare/@tiptap/extension-twitch?minimal=true)
+[![License](https://img.shields.io/npm/l/@tiptap/extension-twitch.svg)](https://www.npmjs.com/package/@tiptap/extension-twitch)
+[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub)](https://github.com/sponsors/ueberdosis)
+
+## Introduction
+
+Tiptap is a headless wrapper around [ProseMirror](https://ProseMirror.net) – a toolkit for building rich text WYSIWYG editors, which is already in use at many well-known companies such as _New York Times_, _The Guardian_ or _Atlassian_.
+
+## Official Documentation
+
+Documentation can be found on the [Tiptap website](https://tiptap.dev).
+
+## License
+
+Tiptap is open sourced software licensed under the [MIT license](https://github.com/ueberdosis/tiptap/blob/main/LICENSE.md).

package/dist/index.cjs

@@ -0,0 +1,256 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TWITCH_REGEX: () => TWITCH_REGEX,
+  TWITCH_REGEX_GLOBAL: () => TWITCH_REGEX_GLOBAL,
+  Twitch: () => Twitch,
+  default: () => index_default,
+  getEmbedUrlFromTwitchUrl: () => getEmbedUrlFromTwitchUrl,
+  getTwitchIdentifier: () => getTwitchIdentifier,
+  isValidTwitchUrl: () => isValidTwitchUrl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/twitch.ts
+var import_core = require("@tiptap/core");
+
+// src/utils.ts
+var TWITCH_REGEX = /^(https?:\/\/)?(www\.)?(twitch\.tv|clips\.twitch\.tv)\/(?:videos\/(\d+)|(\w+)\/clip\/([\w-]+)|([\w-]+)(?:\/)?)?(\?.*)?$/;
+var TWITCH_REGEX_GLOBAL = /^(https?:\/\/)?(www\.)?(twitch\.tv|clips\.twitch\.tv)\/(?:videos\/(\d+)|(\w+)\/clip\/([\w-]+)|([\w-]+)(?:\/)?)?(\?.*)?$/g;
+var isValidTwitchUrl = (url) => {
+  return url.match(TWITCH_REGEX);
+};
+var getTwitchIdentifier = (url) => {
+  if (!isValidTwitchUrl(url)) {
+    return null;
+  }
+  const cleanUrl = url.split("?")[0];
+  if (cleanUrl.includes("clips.twitch.tv/")) {
+    const clipRegex = /clips\.twitch\.tv\/([\w-]+)/;
+    const match = cleanUrl.match(clipRegex);
+    return match ? { type: "clip", id: match[1] } : null;
+  }
+  if (cleanUrl.includes("twitch.tv/")) {
+    const videoRegex = /twitch\.tv\/videos\/(\d+)/;
+    const videoMatch = cleanUrl.match(videoRegex);
+    if (videoMatch) {
+      return { type: "video", id: videoMatch[1] };
+    }
+    const channelClipRegex = /twitch\.tv\/([\w-]+)\/clip\/([\w-]+)/;
+    const clipMatch = cleanUrl.match(channelClipRegex);
+    if (clipMatch) {
+      return { type: "clip", id: clipMatch[2] };
+    }
+    const channelRegex = /twitch\.tv\/([\w-]+)(?:\/)?$/;
+    const channelMatch = cleanUrl.match(channelRegex);
+    if (channelMatch) {
+      return { type: "channel", id: channelMatch[1] };
+    }
+  }
+  return null;
+};
+var getEmbedUrlFromTwitchUrl = (options) => {
+  const { url, allowFullscreen = true, autoplay = false, muted = false, time, parent } = options;
+  const identifier = getTwitchIdentifier(url);
+  if (!identifier) {
+    return null;
+  }
+  const parentDomain = parent || "localhost";
+  if (identifier.type === "clip") {
+    const clipUrl = new URL("https://clips.twitch.tv/embed");
+    clipUrl.searchParams.set("clip", identifier.id);
+    clipUrl.searchParams.set("parent", parentDomain);
+    if (autoplay) {
+      clipUrl.searchParams.set("autoplay", "true");
+    }
+    if (muted) {
+      clipUrl.searchParams.set("muted", "true");
+    }
+    return clipUrl.toString();
+  }
+  if (identifier.type === "video") {
+    const videoUrl = new URL("https://player.twitch.tv/");
+    videoUrl.searchParams.set("video", identifier.id);
+    videoUrl.searchParams.set("parent", parentDomain);
+    if (allowFullscreen) {
+      videoUrl.searchParams.set("allowfullscreen", "true");
+    }
+    if (autoplay) {
+      videoUrl.searchParams.set("autoplay", "true");
+    }
+    if (muted) {
+      videoUrl.searchParams.set("muted", "true");
+    }
+    if (time) {
+      videoUrl.searchParams.set("time", time);
+    }
+    return videoUrl.toString();
+  }
+  if (identifier.type === "channel") {
+    const channelUrl = new URL("https://player.twitch.tv/");
+    channelUrl.searchParams.set("channel", identifier.id);
+    channelUrl.searchParams.set("parent", parentDomain);
+    if (allowFullscreen) {
+      channelUrl.searchParams.set("allowfullscreen", "true");
+    }
+    if (autoplay) {
+      channelUrl.searchParams.set("autoplay", "true");
+    }
+    if (muted) {
+      channelUrl.searchParams.set("muted", "true");
+    }
+    return channelUrl.toString();
+  }
+  return null;
+};
+
+// src/twitch.ts
+var Twitch = import_core.Node.create({
+  name: "twitch",
+  addOptions() {
+    return {
+      addPasteHandler: true,
+      allowFullscreen: true,
+      autoplay: false,
+      muted: false,
+      time: void 0,
+      parent: "localhost",
+      height: 480,
+      width: 640,
+      HTMLAttributes: {},
+      inline: false
+    };
+  },
+  inline() {
+    return this.options.inline;
+  },
+  group() {
+    return this.options.inline ? "inline" : "block";
+  },
+  draggable: true,
+  addAttributes() {
+    return {
+      src: {
+        default: null
+      },
+      width: {
+        default: this.options.width
+      },
+      height: {
+        default: this.options.height
+      },
+      autoplay: {
+        default: this.options.autoplay
+      },
+      muted: {
+        default: this.options.muted
+      },
+      time: {
+        default: this.options.time
+      }
+    };
+  },
+  parseHTML() {
+    return [
+      {
+        tag: "div[data-twitch-video] iframe"
+      }
+    ];
+  },
+  addCommands() {
+    return {
+      setTwitchVideo: (options) => ({ commands }) => {
+        if (!isValidTwitchUrl(options.src)) {
+          return false;
+        }
+        return commands.insertContent({
+          type: this.name,
+          attrs: options
+        });
+      }
+    };
+  },
+  addPasteRules() {
+    if (!this.options.addPasteHandler) {
+      return [];
+    }
+    return [
+      (0, import_core.nodePasteRule)({
+        find: TWITCH_REGEX_GLOBAL,
+        type: this.type,
+        getAttributes: (match) => {
+          return { src: match.input };
+        }
+      })
+    ];
+  },
+  renderHTML({ HTMLAttributes }) {
+    var _a, _b, _c;
+    const embedUrl = getEmbedUrlFromTwitchUrl({
+      url: HTMLAttributes.src,
+      allowFullscreen: this.options.allowFullscreen,
+      autoplay: (_a = HTMLAttributes.autoplay) != null ? _a : this.options.autoplay,
+      muted: (_b = HTMLAttributes.muted) != null ? _b : this.options.muted,
+      time: (_c = HTMLAttributes.time) != null ? _c : this.options.time,
+      parent: this.options.parent
+    });
+    if (!embedUrl) {
+      return ["div", "Invalid Twitch URL"];
+    }
+    HTMLAttributes.src = embedUrl;
+    return [
+      "div",
+      { "data-twitch-video": "" },
+      [
+        "iframe",
+        (0, import_core.mergeAttributes)(
+          this.options.HTMLAttributes,
+          {
+            width: this.options.width,
+            height: this.options.height,
+            allowfullscreen: this.options.allowFullscreen,
+            scrolling: "no",
+            frameborder: "0"
+          },
+          HTMLAttributes
+        )
+      ]
+    ];
+  },
+  ...(0, import_core.createAtomBlockMarkdownSpec)({
+    nodeName: "twitch",
+    allowedAttributes: ["src", "width", "height", "autoplay", "muted", "time"]
+  })
+});
+
+// src/index.ts
+var index_default = Twitch;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TWITCH_REGEX,
+  TWITCH_REGEX_GLOBAL,
+  Twitch,
+  getEmbedUrlFromTwitchUrl,
+  getTwitchIdentifier,
+  isValidTwitchUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/twitch.ts","../src/utils.ts"],"sourcesContent":["import { Twitch } from './twitch.js'\n\nexport * from './twitch.js'\nexport * from './utils.js'\n\nexport default Twitch\n","import { createAtomBlockMarkdownSpec, mergeAttributes, Node, nodePasteRule } from '@tiptap/core'\n\nimport { getEmbedUrlFromTwitchUrl, isValidTwitchUrl, TWITCH_REGEX_GLOBAL } from './utils.js'\n\nexport interface TwitchOptions {\n  /**\n   * Controls if the paste handler for Twitch videos should be added.\n   * @default true\n   * @example false\n   */\n  addPasteHandler: boolean\n\n  /**\n   * Controls if the Twitch video should be allowed to go fullscreen.\n   * @default true\n   * @example false\n   */\n  allowFullscreen: boolean\n\n  /**\n   * Controls if the Twitch video should autoplay.\n   * @default false\n   * @example true\n   */\n  autoplay: boolean\n\n  /**\n   * Controls if the Twitch video should start muted.\n   * @default false\n   * @example true\n   */\n  muted: boolean\n\n  /**\n   * The time in the video where playback starts (format: 1h2m3s).\n   * Only works for video embeds, not for clips or channels.\n   * @default undefined\n   * @example '1h2m3s'\n   */\n  time?: string\n\n  /**\n   * The parent domain for the Twitch embed. Required for embed functionality.\n   * @default 'localhost'\n   * @example 'example.com'\n   */\n  parent: string\n\n  /**\n   * The height of the Twitch video.\n   * @default 480\n   * @example 720\n   */\n  height: number\n\n  /**\n   * The width of the Twitch video.\n   * @default 640\n   * @example 1280\n   */\n  width: number\n\n  /**\n   * The HTML attributes for a Twitch video node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n\n  /**\n   * Controls if the Twitch node should be inline or not.\n   * @default false\n   * @example true\n   */\n  inline: boolean\n}\n\n/**\n * The options for setting a Twitch video.\n */\ntype SetTwitchVideoOptions = {\n  src: string\n  width?: number\n  height?: number\n  autoplay?: boolean\n  muted?: boolean\n  time?: string\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    twitch: {\n      /**\n       * Insert a Twitch video\n       * @param options The Twitch video attributes\n       * @example editor.commands.setTwitchVideo({ src: 'https://www.twitch.tv/videos/1234567890' })\n       */\n      setTwitchVideo: (options: SetTwitchVideoOptions) => ReturnType\n    }\n  }\n}\n\n/**\n * This extension adds support for Twitch videos.\n * @see https://www.tiptap.dev/api/nodes/twitch\n *\n * @example\n * ```ts\n * import { useEditor, EditorContent } from '@tiptap/react'\n * import { StarterKit } from '@tiptap/starter-kit'\n * import { Twitch } from '@tiptap/extension-twitch'\n *\n * const editor = useEditor({\n *   extensions: [\n *     StarterKit,\n *     Twitch.configure({\n *       parent: 'example.com',\n *       allowFullscreen: true,\n *     }),\n *   ],\n *   content: '<p>Hello World!</p>',\n * })\n * ```\n */\nexport const Twitch = Node.create<TwitchOptions>({\n  name: 'twitch',\n\n  addOptions() {\n    return {\n      addPasteHandler: true,\n      allowFullscreen: true,\n      autoplay: false,\n      muted: false,\n      time: undefined,\n      parent: 'localhost',\n      height: 480,\n      width: 640,\n      HTMLAttributes: {},\n      inline: false,\n    }\n  },\n\n  inline() {\n    return this.options.inline\n  },\n\n  group() {\n    return this.options.inline ? 'inline' : 'block'\n  },\n\n  draggable: true,\n\n  addAttributes() {\n    return {\n      src: {\n        default: null,\n      },\n      width: {\n        default: this.options.width,\n      },\n      height: {\n        default: this.options.height,\n      },\n      autoplay: {\n        default: this.options.autoplay,\n      },\n      muted: {\n        default: this.options.muted,\n      },\n      time: {\n        default: this.options.time,\n      },\n    }\n  },\n\n  parseHTML() {\n    return [\n      {\n        tag: 'div[data-twitch-video] iframe',\n      },\n    ]\n  },\n\n  addCommands() {\n    return {\n      setTwitchVideo:\n        (options: SetTwitchVideoOptions) =>\n        ({ commands }) => {\n          if (!isValidTwitchUrl(options.src)) {\n            return false\n          }\n\n          return commands.insertContent({\n            type: this.name,\n            attrs: options,\n          })\n        },\n    }\n  },\n\n  addPasteRules() {\n    if (!this.options.addPasteHandler) {\n      return []\n    }\n\n    return [\n      nodePasteRule({\n        find: TWITCH_REGEX_GLOBAL,\n        type: this.type,\n        getAttributes: match => {\n          return { src: match.input }\n        },\n      }),\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    const embedUrl = getEmbedUrlFromTwitchUrl({\n      url: HTMLAttributes.src,\n      allowFullscreen: this.options.allowFullscreen,\n      autoplay: HTMLAttributes.autoplay ?? this.options.autoplay,\n      muted: HTMLAttributes.muted ?? this.options.muted,\n      time: HTMLAttributes.time ?? this.options.time,\n      parent: this.options.parent,\n    })\n\n    if (!embedUrl) {\n      return ['div', 'Invalid Twitch URL']\n    }\n\n    HTMLAttributes.src = embedUrl\n\n    return [\n      'div',\n      { 'data-twitch-video': '' },\n      [\n        'iframe',\n        mergeAttributes(\n          this.options.HTMLAttributes,\n          {\n            width: this.options.width,\n            height: this.options.height,\n            allowfullscreen: this.options.allowFullscreen,\n            scrolling: 'no',\n            frameborder: '0',\n          },\n          HTMLAttributes,\n        ),\n      ],\n    ]\n  },\n\n  ...createAtomBlockMarkdownSpec({\n    nodeName: 'twitch',\n    allowedAttributes: ['src', 'width', 'height', 'autoplay', 'muted', 'time'],\n  }),\n})\n","/**\n * Regex patterns for matching Twitch URLs\n * Matches:\n * - https://twitch.tv/videos/1234567890\n * - https://www.twitch.tv/videos/1234567890\n * - https://twitch.tv/examplechannel/clip/ClipName-123\n * - https://www.twitch.tv/examplechannel/clip/ClipName-123\n * - https://clips.twitch.tv/ClipName\n * - https://www.clips.twitch.tv/ClipName\n * - https://twitch.tv/examplechannel (channel)\n * - https://www.twitch.tv/examplechannel\n */\nexport const TWITCH_REGEX =\n  /^(https?:\\/\\/)?(www\\.)?(twitch\\.tv|clips\\.twitch\\.tv)\\/(?:videos\\/(\\d+)|(\\w+)\\/clip\\/([\\w-]+)|([\\w-]+)(?:\\/)?)?(\\?.*)?$/\n\nexport const TWITCH_REGEX_GLOBAL =\n  /^(https?:\\/\\/)?(www\\.)?(twitch\\.tv|clips\\.twitch\\.tv)\\/(?:videos\\/(\\d+)|(\\w+)\\/clip\\/([\\w-]+)|([\\w-]+)(?:\\/)?)?(\\?.*)?$/g\n\n/**\n * Validates if a URL is a valid Twitch video, clip or channel URL\n *\n * @param url - The URL to validate\n * @returns true if the URL is a valid Twitch URL\n *\n * @example\n * ```ts\n * isValidTwitchUrl('https://www.twitch.tv/videos/1234567890') // true\n * isValidTwitchUrl('https://www.twitch.tv/examplechannel/clip/ExampleClipName') // true\n * isValidTwitchUrl('https://www.twitch.tv/examplechannel') // true\n * isValidTwitchUrl('https://clips.twitch.tv/ExampleClipName') // true\n * isValidTwitchUrl('invalid') // false\n * ```\n */\nexport const isValidTwitchUrl = (url: string) => {\n  return url.match(TWITCH_REGEX)\n}\n\nexport interface GetEmbedUrlOptions {\n  url: string\n  allowFullscreen?: boolean\n  autoplay?: boolean\n  muted?: boolean\n  time?: string\n  parent?: string\n}\n\n/**\n * Extracts the video, clip or channel identifier from a Twitch URL\n *\n * @param url - The Twitch URL\n * @returns Object containing type ('video', 'clip' or 'channel') and ID, or null if invalid\n *\n * @example\n * ```ts\n * getTwitchIdentifier('https://www.twitch.tv/videos/1234567890')\n * // { type: 'video', id: '1234567890' }\n *\n * getTwitchIdentifier('https://www.twitch.tv/examplechannel/clip/ExampleClipName-ABC123')\n * // { type: 'clip', id: 'ExampleClipName-ABC123' }\n *\n * getTwitchIdentifier('https://www.twitch.tv/examplechannel')\n * // { type: 'channel', id: 'examplechannel' }\n * ```\n */\nexport const getTwitchIdentifier = (url: string): { type: 'video' | 'clip' | 'channel'; id: string } | null => {\n  if (!isValidTwitchUrl(url)) {\n    return null\n  }\n\n  // Remove query parameters\n  const cleanUrl = url.split('?')[0]\n\n  // Handle clip URLs from clips.twitch.tv\n  if (cleanUrl.includes('clips.twitch.tv/')) {\n    const clipRegex = /clips\\.twitch\\.tv\\/([\\w-]+)/\n    const match = cleanUrl.match(clipRegex)\n    return match ? { type: 'clip', id: match[1] } : null\n  }\n\n  // Handle twitch.tv URLs\n  if (cleanUrl.includes('twitch.tv/')) {\n    // Check if it's a video URL (videos/ID)\n    const videoRegex = /twitch\\.tv\\/videos\\/(\\d+)/\n    const videoMatch = cleanUrl.match(videoRegex)\n    if (videoMatch) {\n      return { type: 'video', id: videoMatch[1] }\n    }\n\n    // Check if it's a clip URL (channel/clip/clipname)\n    const channelClipRegex = /twitch\\.tv\\/([\\w-]+)\\/clip\\/([\\w-]+)/\n    const clipMatch = cleanUrl.match(channelClipRegex)\n    if (clipMatch) {\n      return { type: 'clip', id: clipMatch[2] }\n    }\n\n    // Otherwise it's a channel URL\n    const channelRegex = /twitch\\.tv\\/([\\w-]+)(?:\\/)?$/\n    const channelMatch = cleanUrl.match(channelRegex)\n    if (channelMatch) {\n      return { type: 'channel', id: channelMatch[1] }\n    }\n  }\n\n  return null\n}\n\n/**\n * Generates an embed URL from a Twitch video, clip or channel URL with optional parameters\n *\n * @param options - The embed URL options\n * @returns The embed URL or null if invalid\n *\n * @example\n * ```ts\n * getEmbedUrlFromTwitchUrl({\n *   url: 'https://www.twitch.tv/videos/1234567890',\n *   parent: 'example.com',\n *   muted: true,\n *   time: '1h2m3s'\n * })\n * // Returns: https://player.twitch.tv/?video=1234567890&parent=example.com&muted=true&time=1h2m3s\n *\n * getEmbedUrlFromTwitchUrl({\n *   url: 'https://www.twitch.tv/examplechannel/clip/ExampleClipName-ABC123',\n *   parent: 'example.com',\n *   autoplay: true,\n *   muted: true\n * })\n * // Returns: https://clips.twitch.tv/embed?clip=ExampleClipName-ABC123&parent=example.com&autoplay=true&muted=true\n *\n * getEmbedUrlFromTwitchUrl({\n *   url: 'https://www.twitch.tv/examplechannel',\n *   parent: 'example.com'\n * })\n * // Returns: https://player.twitch.tv/?channel=examplechannel&parent=example.com\n * ```\n */\nexport const getEmbedUrlFromTwitchUrl = (options: GetEmbedUrlOptions): string | null => {\n  const { url, allowFullscreen = true, autoplay = false, muted = false, time, parent } = options\n\n  const identifier = getTwitchIdentifier(url)\n\n  if (!identifier) {\n    return null\n  }\n\n  const parentDomain = parent || 'localhost'\n\n  // Handle clip URLs\n  if (identifier.type === 'clip') {\n    const clipUrl = new URL('https://clips.twitch.tv/embed')\n    clipUrl.searchParams.set('clip', identifier.id)\n    clipUrl.searchParams.set('parent', parentDomain)\n\n    if (autoplay) {\n      clipUrl.searchParams.set('autoplay', 'true')\n    }\n\n    if (muted) {\n      clipUrl.searchParams.set('muted', 'true')\n    }\n\n    return clipUrl.toString()\n  }\n\n  // Handle video URLs\n  if (identifier.type === 'video') {\n    const videoUrl = new URL('https://player.twitch.tv/')\n    videoUrl.searchParams.set('video', identifier.id)\n    videoUrl.searchParams.set('parent', parentDomain)\n\n    if (allowFullscreen) {\n      videoUrl.searchParams.set('allowfullscreen', 'true')\n    }\n\n    if (autoplay) {\n      videoUrl.searchParams.set('autoplay', 'true')\n    }\n\n    if (muted) {\n      videoUrl.searchParams.set('muted', 'true')\n    }\n\n    if (time) {\n      videoUrl.searchParams.set('time', time)\n    }\n\n    return videoUrl.toString()\n  }\n\n  // Handle channel URLs\n  if (identifier.type === 'channel') {\n    const channelUrl = new URL('https://player.twitch.tv/')\n    channelUrl.searchParams.set('channel', identifier.id)\n    channelUrl.searchParams.set('parent', parentDomain)\n\n    if (allowFullscreen) {\n      channelUrl.searchParams.set('allowfullscreen', 'true')\n    }\n\n    if (autoplay) {\n      channelUrl.searchParams.set('autoplay', 'true')\n    }\n\n    if (muted) {\n      channelUrl.searchParams.set('muted', 'true')\n    }\n\n    return channelUrl.toString()\n  }\n\n  return null\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,206 @@
+import { Node } from '@tiptap/core';
+
+interface TwitchOptions {
+    /**
+     * Controls if the paste handler for Twitch videos should be added.
+     * @default true
+     * @example false
+     */
+    addPasteHandler: boolean;
+    /**
+     * Controls if the Twitch video should be allowed to go fullscreen.
+     * @default true
+     * @example false
+     */
+    allowFullscreen: boolean;
+    /**
+     * Controls if the Twitch video should autoplay.
+     * @default false
+     * @example true
+     */
+    autoplay: boolean;
+    /**
+     * Controls if the Twitch video should start muted.
+     * @default false
+     * @example true
+     */
+    muted: boolean;
+    /**
+     * The time in the video where playback starts (format: 1h2m3s).
+     * Only works for video embeds, not for clips or channels.
+     * @default undefined
+     * @example '1h2m3s'
+     */
+    time?: string;
+    /**
+     * The parent domain for the Twitch embed. Required for embed functionality.
+     * @default 'localhost'
+     * @example 'example.com'
+     */
+    parent: string;
+    /**
+     * The height of the Twitch video.
+     * @default 480
+     * @example 720
+     */
+    height: number;
+    /**
+     * The width of the Twitch video.
+     * @default 640
+     * @example 1280
+     */
+    width: number;
+    /**
+     * The HTML attributes for a Twitch video node.
+     * @default {}
+     * @example { class: 'foo' }
+     */
+    HTMLAttributes: Record<string, any>;
+    /**
+     * Controls if the Twitch node should be inline or not.
+     * @default false
+     * @example true
+     */
+    inline: boolean;
+}
+/**
+ * The options for setting a Twitch video.
+ */
+type SetTwitchVideoOptions = {
+    src: string;
+    width?: number;
+    height?: number;
+    autoplay?: boolean;
+    muted?: boolean;
+    time?: string;
+};
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        twitch: {
+            /**
+             * Insert a Twitch video
+             * @param options The Twitch video attributes
+             * @example editor.commands.setTwitchVideo({ src: 'https://www.twitch.tv/videos/1234567890' })
+             */
+            setTwitchVideo: (options: SetTwitchVideoOptions) => ReturnType;
+        };
+    }
+}
+/**
+ * This extension adds support for Twitch videos.
+ * @see https://www.tiptap.dev/api/nodes/twitch
+ *
+ * @example
+ * ```ts
+ * import { useEditor, EditorContent } from '@tiptap/react'
+ * import { StarterKit } from '@tiptap/starter-kit'
+ * import { Twitch } from '@tiptap/extension-twitch'
+ *
+ * const editor = useEditor({
+ *   extensions: [
+ *     StarterKit,
+ *     Twitch.configure({
+ *       parent: 'example.com',
+ *       allowFullscreen: true,
+ *     }),
+ *   ],
+ *   content: '<p>Hello World!</p>',
+ * })
+ * ```
+ */
+declare const Twitch: Node<TwitchOptions, any>;
+
+/**
+ * Regex patterns for matching Twitch URLs
+ * Matches:
+ * - https://twitch.tv/videos/1234567890
+ * - https://www.twitch.tv/videos/1234567890
+ * - https://twitch.tv/examplechannel/clip/ClipName-123
+ * - https://www.twitch.tv/examplechannel/clip/ClipName-123
+ * - https://clips.twitch.tv/ClipName
+ * - https://www.clips.twitch.tv/ClipName
+ * - https://twitch.tv/examplechannel (channel)
+ * - https://www.twitch.tv/examplechannel
+ */
+declare const TWITCH_REGEX: RegExp;
+declare const TWITCH_REGEX_GLOBAL: RegExp;
+/**
+ * Validates if a URL is a valid Twitch video, clip or channel URL
+ *
+ * @param url - The URL to validate
+ * @returns true if the URL is a valid Twitch URL
+ *
+ * @example
+ * ```ts
+ * isValidTwitchUrl('https://www.twitch.tv/videos/1234567890') // true
+ * isValidTwitchUrl('https://www.twitch.tv/examplechannel/clip/ExampleClipName') // true
+ * isValidTwitchUrl('https://www.twitch.tv/examplechannel') // true
+ * isValidTwitchUrl('https://clips.twitch.tv/ExampleClipName') // true
+ * isValidTwitchUrl('invalid') // false
+ * ```
+ */
+declare const isValidTwitchUrl: (url: string) => RegExpMatchArray | null;
+interface GetEmbedUrlOptions {
+    url: string;
+    allowFullscreen?: boolean;
+    autoplay?: boolean;
+    muted?: boolean;
+    time?: string;
+    parent?: string;
+}
+/**
+ * Extracts the video, clip or channel identifier from a Twitch URL
+ *
+ * @param url - The Twitch URL
+ * @returns Object containing type ('video', 'clip' or 'channel') and ID, or null if invalid
+ *
+ * @example
+ * ```ts
+ * getTwitchIdentifier('https://www.twitch.tv/videos/1234567890')
+ * // { type: 'video', id: '1234567890' }
+ *
+ * getTwitchIdentifier('https://www.twitch.tv/examplechannel/clip/ExampleClipName-ABC123')
+ * // { type: 'clip', id: 'ExampleClipName-ABC123' }
+ *
+ * getTwitchIdentifier('https://www.twitch.tv/examplechannel')
+ * // { type: 'channel', id: 'examplechannel' }
+ * ```
+ */
+declare const getTwitchIdentifier: (url: string) => {
+    type: "video" | "clip" | "channel";
+    id: string;
+} | null;
+/**
+ * Generates an embed URL from a Twitch video, clip or channel URL with optional parameters
+ *
+ * @param options - The embed URL options
+ * @returns The embed URL or null if invalid
+ *
+ * @example
+ * ```ts
+ * getEmbedUrlFromTwitchUrl({
+ *   url: 'https://www.twitch.tv/videos/1234567890',
+ *   parent: 'example.com',
+ *   muted: true,
+ *   time: '1h2m3s'
+ * })
+ * // Returns: https://player.twitch.tv/?video=1234567890&parent=example.com&muted=true&time=1h2m3s
+ *
+ * getEmbedUrlFromTwitchUrl({
+ *   url: 'https://www.twitch.tv/examplechannel/clip/ExampleClipName-ABC123',
+ *   parent: 'example.com',
+ *   autoplay: true,
+ *   muted: true
+ * })
+ * // Returns: https://clips.twitch.tv/embed?clip=ExampleClipName-ABC123&parent=example.com&autoplay=true&muted=true
+ *
+ * getEmbedUrlFromTwitchUrl({
+ *   url: 'https://www.twitch.tv/examplechannel',
+ *   parent: 'example.com'
+ * })
+ * // Returns: https://player.twitch.tv/?channel=examplechannel&parent=example.com
+ * ```
+ */
+declare const getEmbedUrlFromTwitchUrl: (options: GetEmbedUrlOptions) => string | null;
+
+export { type GetEmbedUrlOptions, TWITCH_REGEX, TWITCH_REGEX_GLOBAL, Twitch, type TwitchOptions, Twitch as default, getEmbedUrlFromTwitchUrl, getTwitchIdentifier, isValidTwitchUrl };