vuepress-plugin-md-power 1.0.0-rc.100

package/lib/client/composables/size.d.ts

@@ -0,0 +1,26 @@
+import { MaybeRef } from '@vueuse/core';
+import { ShallowRef, Ref, ToRefs } from 'vue';
+import { SizeOptions } from '../../shared/index.js';
+
+/**
+ * Fork for https://github.com/vuepress-theme-hope/vuepress-theme-hope/blob/main/packages/components/src/client/composables/useSize.ts
+ *
+ * The MIT License (MIT)
+ * Copyright (C) 2021 - PRESENT by Mr.Hope<mister-hope@outlook.com>
+ *
+ * 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.
+ */
+
+interface SizeInfo<T extends HTMLElement> {
+    el: ShallowRef<T | undefined>;
+    width: Ref<string>;
+    height: Ref<string>;
+    resize: () => void;
+}
+declare function useSize<T extends HTMLElement>(options: ToRefs<SizeOptions>, extraHeight?: MaybeRef<number>): SizeInfo<T>;
+
+export { type SizeInfo, useSize };

package/lib/client/composables/size.js

@@ -0,0 +1,37 @@
+// src/client/composables/size.ts
+import { useEventListener } from "@vueuse/core";
+import { computed, isRef, onMounted, ref, shallowRef, toValue, watch } from "vue";
+function useSize(options, extraHeight = 0) {
+  const el = shallowRef();
+  const width = computed(() => toValue(options.width) || "100%");
+  const height = ref("auto");
+  const getHeight = (width2) => {
+    const height2 = toValue(options.height);
+    const ratio = getRadio(toValue(options.ratio));
+    return height2 || `${Number(width2) / ratio + toValue(extraHeight)}px`;
+  };
+  const resize = () => {
+    if (el.value)
+      height.value = getHeight(el.value.offsetWidth);
+  };
+  onMounted(() => {
+    resize();
+    if (isRef(extraHeight))
+      watch(extraHeight, resize);
+    useEventListener("orientationchange", resize);
+    useEventListener("resize", resize);
+  });
+  return { el, width, height, resize };
+}
+function getRadio(ratio) {
+  if (typeof ratio === "string") {
+    const [width, height] = ratio.split(":");
+    const parsedRadio = Number(width) / Number(height);
+    if (!Number.isNaN(parsedRadio))
+      return parsedRadio;
+  }
+  return typeof ratio === "number" ? ratio : 16 / 9;
+}
+export {
+  useSize
+};

package/lib/client/index.d.ts

@@ -0,0 +1 @@
+export * from '../shared/index.js';

package/lib/client/index.js

@@ -0,0 +1,2 @@
+// src/client/index.ts
+export * from "../shared/index.js";

package/lib/client/options.d.ts

@@ -0,0 +1,5 @@
+import { MarkdownPowerPluginOptions } from '../shared/index.js';
+
+declare const pluginOptions: MarkdownPowerPluginOptions;
+
+export { pluginOptions };

package/lib/client/options.js

@@ -0,0 +1,5 @@
+// src/client/options.ts
+var pluginOptions = __MD_POWER_INJECT_OPTIONS__;
+export {
+  pluginOptions
+};

package/lib/client/shim.d.ts

@@ -0,0 +1,7 @@
+import type { ReplEditorData } from '../shared/repl.js'
+
+declare module '@internal/md-power/replEditorData' {
+
+  const res: ReplEditorData
+  export default res
+}

package/lib/client/utils/http.d.ts

@@ -0,0 +1,6 @@
+declare const http: {
+    get: <T extends object = object, R = any>(url: string, query?: T) => Promise<R>;
+    post: <T extends object = object, R = any>(url: string, data?: T) => Promise<R>;
+};
+
+export { http };

package/lib/client/utils/http.js

@@ -0,0 +1,25 @@
+// src/client/utils/http.ts
+var http = {
+  get: async (url, query) => {
+    const _url = new URL(url);
+    if (query) {
+      for (const [key, value] of Object.entries(query))
+        _url.searchParams.append(key, value);
+    }
+    const res = await fetch(_url.toString());
+    return await res.json();
+  },
+  post: async (url, data) => {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: data ? JSON.stringify(data) : void 0
+    });
+    return await res.json();
+  }
+};
+export {
+  http
+};

package/lib/client/utils/is.d.ts

@@ -0,0 +1,5 @@
+declare function checkIsMobile(ua: string): boolean;
+declare function checkIsSafari(ua: string): boolean;
+declare function checkIsiPad(ua: string): boolean;
+
+export { checkIsMobile, checkIsSafari, checkIsiPad };

package/lib/client/utils/is.js

@@ -0,0 +1,19 @@
+// src/client/utils/is.ts
+function checkIsMobile(ua) {
+  return /\b(?:Android|iPhone)/i.test(ua);
+}
+function checkIsSafari(ua) {
+  return /version\/[\w.]+ .*(?:mobile ?safari|safari)/i.test(ua);
+}
+function checkIsiPad(ua) {
+  return [
+    /\((ipad);[-\w),; ]+apple/i,
+    /applecoremedia\/[\w.]+ \((ipad)/i,
+    /\b(ipad)\d\d?,\d\d?[;\]].+ios/i
+  ].some((item) => item.test(ua));
+}
+export {
+  checkIsMobile,
+  checkIsSafari,
+  checkIsiPad
+};

package/lib/client/utils/link.d.ts

@@ -0,0 +1,3 @@
+declare function normalizeLink(url: string): string;
+
+export { normalizeLink };

package/lib/client/utils/link.js

@@ -0,0 +1,9 @@
+// src/client/utils/link.ts
+import { withBase } from "vuepress/client";
+import { isLinkHttp } from "vuepress/shared";
+function normalizeLink(url) {
+  return isLinkHttp(url) ? url : withBase(url);
+}
+export {
+  normalizeLink
+};

package/lib/client/utils/sleep.d.ts

@@ -0,0 +1,3 @@
+declare function sleep(ms: number): Promise<void>;
+
+export { sleep };

package/lib/client/utils/sleep.js

@@ -0,0 +1,9 @@
+// src/client/utils/sleep.ts
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+export {
+  sleep
+};

package/lib/node/index.d.ts

@@ -0,0 +1,287 @@
+import { BuiltinTheme, ThemeRegistration } from 'shiki';
+import { App } from 'vuepress';
+import { Plugin } from 'vuepress/core';
+
+type CanIUseMode = 'embed' | 'image';
+interface CanIUseTokenMeta {
+    feature: string;
+    mode: CanIUseMode;
+    versions: string;
+}
+interface CanIUseOptions {
+    /**
+     * 嵌入模式
+     *
+     * embed 通过iframe嵌入，提供可交互视图
+     *
+     * image 通过图片嵌入，静态
+     *
+     * @default 'embed'
+     */
+    mode?: CanIUseMode;
+}
+
+interface SizeOptions {
+    width?: string;
+    height?: string;
+    ratio?: number | string;
+}
+
+interface CodepenTokenMeta extends SizeOptions {
+    title?: string;
+    user?: string;
+    slash?: string;
+    tab?: string;
+    theme?: string;
+    preview?: boolean;
+    editable?: boolean;
+}
+
+interface CodeSandboxTokenMeta extends SizeOptions {
+    user?: string;
+    id?: string;
+    layout?: string;
+    type?: 'button' | 'embed';
+    title?: string;
+    filepath?: string;
+    navbar?: boolean;
+    console?: boolean;
+}
+
+interface IconsOptions {
+    /**
+     * The prefix of the icon className
+     * @default 'vp-mdi'
+     */
+    prefix?: string;
+    /**
+     * The size of the icon
+     * @default '1em'
+     */
+    size?: string | number;
+    /**
+     * The color of the icon
+     * @default 'currentColor'
+     */
+    color?: string;
+}
+
+interface JSFiddleTokenMeta extends SizeOptions {
+    user?: string;
+    id?: string;
+    title?: string;
+    theme?: string;
+    tab?: string;
+}
+
+type PDFEmbedType = 'iframe' | 'embed' | 'pdfjs';
+interface PDFTokenMeta extends SizeOptions {
+    page?: number;
+    noToolbar?: boolean;
+    zoom?: number;
+    src?: string;
+    title?: string;
+}
+interface PDFOptions {
+    /**
+     * pdfjs url
+     */
+    pdfjsUrl?: string;
+}
+
+interface PlotOptions {
+    /**
+     * 是否启用 `=| |=`  markdown （该标记为非标准标记，脱离插件将不生效）
+     * @default true
+     */
+    tag?: boolean;
+    /**
+     * 遮罩层颜色
+     */
+    mask?: string | {
+        light: string;
+        dark: string;
+    };
+    /**
+     * 文本颜色
+     */
+    color?: string | {
+        light: string;
+        dark: string;
+    };
+    /**
+     * 触发方式
+     *
+     * @default 'hover'
+     */
+    trigger?: 'hover' | 'click';
+}
+
+type ThemeOptions = BuiltinTheme | {
+    light: BuiltinTheme;
+    dark: BuiltinTheme;
+};
+interface ReplOptions {
+    theme?: ThemeOptions;
+    go?: boolean;
+    kotlin?: boolean;
+    rust?: boolean;
+}
+interface ReplEditorData {
+    grammars: {
+        go?: any;
+        kotlin?: any;
+        rust?: any;
+    };
+    theme: ThemeRegistration | {
+        light: ThemeRegistration;
+        dark: ThemeRegistration;
+    };
+}
+
+interface MarkdownPowerPluginOptions {
+    /**
+     * 是否启用 PDF 嵌入语法
+     *
+     * `@[pdf](pdf_url)`
+     *
+     * @default false
+     */
+    pdf?: boolean | PDFOptions;
+    /**
+     * 是否启用 iconify 图标嵌入语法
+     *
+     * `:[collect:icon_name]:`
+     *
+     * @default false
+     */
+    icons?: boolean | IconsOptions;
+    /**
+     * 是否启用 隐秘文本 语法
+     *
+     * `!!plot_content!!`
+     *
+     * @default false
+     */
+    plot?: boolean | PlotOptions;
+    /**
+     * 是否启用 bilibili 视频嵌入
+     *
+     * `@[bilibili](bid)`
+     *
+     * @default false
+     */
+    bilibili?: boolean;
+    /**
+     * 是否启用 youtube 视频嵌入
+     *
+     * `@[youtube](video_id)`
+     *
+     * @default false
+     */
+    youtube?: boolean;
+    /**
+     * 是否启用 codepen 嵌入
+     *
+     * `@[codepen](pen_id)`
+     *
+     * @default false
+     */
+    codepen?: boolean;
+    /**
+     * @deprecated
+     */
+    replit?: boolean;
+    /**
+     * 是否启用 codeSandbox 嵌入
+     *
+     * `@[codesandbox](codesandbox_id)`
+     *
+     * @default false
+     */
+    codeSandbox?: boolean;
+    /**
+     * 是否启用 jsfiddle 嵌入
+     *
+     * `@[jsfiddle](jsfiddle_id)`
+     *
+     * @default false
+     */
+    jsfiddle?: boolean;
+    /**
+     * 是否启用 REPL 容器语法
+     *
+     * @default false
+     */
+    repl?: false | ReplOptions;
+    /**
+     * 是否启用 文件树 容器语法
+     *
+     * @default false
+     */
+    fileTree?: boolean;
+    /**
+     * 是否启用 caniuse 嵌入语法
+     *
+     * `@[caniuse](feature_name)`
+     *
+     * @default false
+     */
+    caniuse?: boolean | CanIUseOptions;
+    /**
+     * 是否启用 自动填充 图片宽高属性
+     *
+     * __请注意，无论是否启用，该功能仅在构建生产包时生效__
+     *
+     * - 如果为 `true` ，等同于 `'local'`
+     * - 如果为 `local`，则仅对本地图片 添加 width 和 height
+     * - 如果为 `all`，则对所有图片(即包括 本地 和 远程) 添加 width 和 height
+     *
+     * 图片在加载过程中如果比较慢，从加载到完成的过程会导致页面布局不稳定，导致内容闪烁等。
+     * 此功能通过给图片添加 `width` 和 `height` 属性来解决该问题。
+     *
+     * 请谨慎使用 `all` 选项，该选项会在构建阶段发起网络请求，尝试加载远程图片以获取图片尺寸信息，
+     * 这可能会导致 构建时间变得更长（幸运的是获取尺寸信息只需要加载图片 几 KB 的数据包，因此耗时不会过长）
+     *
+     * @default false
+     */
+    imageSize?: boolean | 'local' | 'all';
+}
+
+interface ReplitTokenMeta extends SizeOptions {
+    title?: string;
+    source?: string;
+    theme?: string;
+}
+
+interface VideoOptions {
+    bilibili?: boolean;
+    youtube?: boolean;
+}
+interface BilibiliTokenMeta extends SizeOptions {
+    title?: string;
+    bvid?: string;
+    aid?: string;
+    cid?: string;
+    autoplay?: boolean;
+    time?: string | number;
+    page?: number;
+}
+interface YoutubeTokenMeta extends SizeOptions {
+    title?: string;
+    id: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    start?: string | number;
+    end?: string | number;
+}
+
+interface ImgSize {
+    width: number;
+    height: number;
+}
+declare function resolveImageSize(app: App, url: string, remote?: boolean): Promise<ImgSize>;
+
+declare function markdownPowerPlugin(options?: MarkdownPowerPluginOptions): Plugin;
+
+export { type BilibiliTokenMeta, type CanIUseMode, type CanIUseOptions, type CanIUseTokenMeta, type CodeSandboxTokenMeta, type CodepenTokenMeta, type IconsOptions, type JSFiddleTokenMeta, type MarkdownPowerPluginOptions, type PDFEmbedType, type PDFOptions, type PDFTokenMeta, type PlotOptions, type ReplEditorData, type ReplOptions, type ReplitTokenMeta, type SizeOptions, type ThemeOptions, type VideoOptions, type YoutubeTokenMeta, markdownPowerPlugin, resolveImageSize };