mark-deco 0.27.0 → 0.28.0

package/dist/browser.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.27.0
+ * version: 0.28.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 9eedf400a4634e8dc23d3f7e05356df3f0a7a77f
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
  */
 
 "use strict";

package/dist/browser.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.27.0
+ * version: 0.28.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 9eedf400a4634e8dc23d3f7e05356df3f0a7a77f
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
  */
 
 /**

package/dist/browser.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.27.0
+ * version: 0.28.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 9eedf400a4634e8dc23d3f7e05356df3f0a7a77f
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
  */
 
 import { createMutex } from "async-primitives";

package/dist/card-oembed-fallback.cjs

@@ -0,0 +1,40 @@
+/*!
+ * name: mark-deco
+ * version: 0.28.0
+ * description: Flexible Markdown to HTML conversion library
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/mark-deco
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ */
+
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const htmlGenerator = require("./html-generator-BKd2MyoO.cjs");
+const isProviderNotFoundError = (error) => {
+  return error instanceof Error && error.message.startsWith("No oEmbed provider found for URL:");
+};
+const createCardOEmbedFallback = (providerList, options = {}) => {
+  const { maxRedirects = 5, timeoutEachRedirect = 1e4 } = options;
+  return {
+    render: async (url, context) => {
+      try {
+        const oembedData = await htmlGenerator.fetchOEmbedData(
+          url,
+          maxRedirects,
+          timeoutEachRedirect,
+          context,
+          providerList
+        );
+        return htmlGenerator.generateHtml(oembedData, url, options);
+      } catch (error) {
+        if (error instanceof htmlGenerator.CORSError || isProviderNotFoundError(error)) {
+          return void 0;
+        }
+        throw error;
+      }
+    }
+  };
+};
+exports.createCardOEmbedFallback = createCardOEmbedFallback;
+//# sourceMappingURL=card-oembed-fallback.cjs.map

package/dist/card-oembed-fallback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-oembed-fallback.cjs","sources":["../src/plugins/card/oembed-fallback.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport { CORSError, fetchOEmbedData } from '../oembed/fetcher';\nimport { generateHtml } from '../oembed/html-generator';\nimport type { OEmbedPluginOptions, OEmbedProvider } from '../oembed/types';\nimport type { CardOEmbedFallback } from './types';\n\nconst isProviderNotFoundError = (error: unknown): boolean => {\n  return (\n    error instanceof Error &&\n    error.message.startsWith('No oEmbed provider found for URL:')\n  );\n};\n\n/**\n * Create an oEmbed fallback renderer for card blocks\n * @param providerList - List of oEmbed providers to use\n * @param options - Configuration options for oEmbed fetching/rendering\n * @returns Fallback renderer for card plugin\n */\nexport const createCardOEmbedFallback = (\n  providerList: OEmbedProvider[],\n  options: OEmbedPluginOptions = {}\n): CardOEmbedFallback => {\n  const { maxRedirects = 5, timeoutEachRedirect = 10000 } = options;\n\n  return {\n    render: async (url, context) => {\n      try {\n        const oembedData = await fetchOEmbedData(\n          url,\n          maxRedirects,\n          timeoutEachRedirect,\n          context,\n          providerList\n        );\n        return generateHtml(oembedData, url, options);\n      } catch (error) {\n        if (error instanceof CORSError || isProviderNotFoundError(error)) {\n          return undefined;\n        }\n        throw error;\n      }\n    },\n  };\n};\n"],"names":["fetchOEmbedData","generateHtml","CORSError"],"mappings":";;;;;;;;;;;;;AAUA,MAAM,0BAA0B,CAAC,UAA4B;AAC3D,SACE,iBAAiB,SACjB,MAAM,QAAQ,WAAW,mCAAmC;AAEhE;AAQO,MAAM,2BAA2B,CACtC,cACA,UAA+B,OACR;AACvB,QAAM,EAAE,eAAe,GAAG,sBAAsB,QAAU;AAE1D,SAAO;AAAA,IACL,QAAQ,OAAO,KAAK,YAAY;AAC9B,UAAI;AACF,cAAM,aAAa,MAAMA,cAAAA;AAAAA,UACvB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAEF,eAAOC,2BAAa,YAAY,KAAK,OAAO;AAAA,MAC9C,SAAS,OAAO;AACd,YAAI,iBAAiBC,cAAAA,aAAa,wBAAwB,KAAK,GAAG;AAChE,iBAAO;AAAA,QACT;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EAAA;AAEJ;;"}

package/dist/card-oembed-fallback.d.ts

@@ -0,0 +1,123 @@
+/*!
+ * name: mark-deco
+ * version: 0.28.0
+ * description: Flexible Markdown to HTML conversion library
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/mark-deco
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ */
+
+/**
+ * Optional oEmbed fallback renderer for card blocks
+ */
+export declare interface CardOEmbedFallback {
+    /** Render oEmbed HTML for the URL, or return undefined to continue with card rendering */
+    render: (url: string, context: MarkdownProcessorPluginContext) => Promise<string | undefined>;
+}
+
+/**
+ * Create an oEmbed fallback renderer for card blocks
+ * @param providerList - List of oEmbed providers to use
+ * @param options - Configuration options for oEmbed fetching/rendering
+ * @returns Fallback renderer for card plugin
+ */
+export declare const createCardOEmbedFallback: (providerList: OEmbedProvider[], options?: OEmbedPluginOptions) => CardOEmbedFallback;
+
+/**
+ * Fetcher interface that encapsulates both fetching function and metadata
+ */
+declare interface FetcherType {
+    /** The actual fetcher function */
+    readonly rawFetcher: (url: string, accept: string, signal: AbortSignal | undefined, logger?: Logger) => Promise<Response>;
+    /** User-Agent string used for fetcher HTTP requests */
+    readonly userAgent: string;
+}
+
+/**
+ * Frontmatter data extracted from markdown
+ */
+declare interface FrontmatterData {
+    readonly [key: string]: unknown;
+}
+
+/**
+ * Logger interface for customizable logging
+ */
+declare interface Logger {
+    readonly debug: (message: string, ...args: unknown[]) => void;
+    readonly info: (message: string, ...args: unknown[]) => void;
+    readonly warn: (message: string, ...args: unknown[]) => void;
+    readonly error: (message: string, ...args: unknown[]) => void;
+}
+
+/**
+ * Context provided to plugins during processing
+ */
+declare interface MarkdownProcessorPluginContext {
+    /** Logger instance for output */
+    readonly logger: Logger;
+    /** AbortSignal for cancelling the operation */
+    readonly signal: AbortSignal | undefined;
+    /** Frontmatter data extracted from the markdown */
+    readonly frontmatter: FrontmatterData;
+    /** Generate unique ID with consistent prefix+counter approach */
+    readonly getUniqueId: () => string;
+    /** Fetch function for HTTP requests */
+    readonly fetcher: FetcherType;
+}
+
+/**
+ * oEmbed provider endpoint interface
+ */
+declare interface OEmbedEndpoint {
+    url: string;
+    schemes?: string[];
+    discovery?: boolean;
+    formats?: string[];
+}
+
+/**
+ * oEmbed plugin display fields interface
+ */
+declare interface OEmbedPluginDisplayFields {
+    /** Display order for the title (default: undefined - not displayed, number: display order) */
+    title?: number;
+    /** Display order for the thumbnail image (default: undefined - not displayed, number: display order) */
+    thumbnail?: number;
+    /** Display order for the author information (default: undefined - not displayed, number: display order) */
+    author?: number;
+    /** Display order for the provider information (default: undefined - not displayed, number: display order) */
+    provider?: number;
+    /** Display order for the description (default: undefined - not displayed, number: display order) */
+    description?: number;
+    /** Display order for the embedded content (video/rich HTML) (default: undefined - not displayed, number: display order) */
+    embeddedContent?: number;
+    /** Display order for the external link to the source (default: undefined - not displayed, number: display order) */
+    externalLink?: number;
+}
+
+/**
+ * oEmbed plugin options
+ */
+export declare interface OEmbedPluginOptions {
+    /** Maximum number of redirects to follow */
+    maxRedirects?: number;
+    /** Timeout for each redirect request in milliseconds */
+    timeoutEachRedirect?: number;
+    /** Whether to use metadata URL (from oEmbed response) for links instead of provided URL (default: false) */
+    useMetadataUrlLink?: boolean;
+    /** Control which metadata fields to display in the generated HTML */
+    displayFields?: OEmbedPluginDisplayFields;
+}
+
+/**
+ * oEmbed provider interface from providers.json
+ */
+export declare interface OEmbedProvider {
+    provider_name: string;
+    provider_url: string;
+    endpoints: OEmbedEndpoint[];
+}
+
+export { }

package/dist/card-oembed-fallback.mjs

@@ -0,0 +1,40 @@
+/*!
+ * name: mark-deco
+ * version: 0.28.0
+ * description: Flexible Markdown to HTML conversion library
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/mark-deco
+ * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ */
+
+import { f as fetchOEmbedData, b as generateHtml, C as CORSError } from "./html-generator-CClcgkAK.js";
+const isProviderNotFoundError = (error) => {
+  return error instanceof Error && error.message.startsWith("No oEmbed provider found for URL:");
+};
+const createCardOEmbedFallback = (providerList, options = {}) => {
+  const { maxRedirects = 5, timeoutEachRedirect = 1e4 } = options;
+  return {
+    render: async (url, context) => {
+      try {
+        const oembedData = await fetchOEmbedData(
+          url,
+          maxRedirects,
+          timeoutEachRedirect,
+          context,
+          providerList
+        );
+        return generateHtml(oembedData, url, options);
+      } catch (error) {
+        if (error instanceof CORSError || isProviderNotFoundError(error)) {
+          return void 0;
+        }
+        throw error;
+      }
+    }
+  };
+};
+export {
+  createCardOEmbedFallback
+};
+//# sourceMappingURL=card-oembed-fallback.mjs.map

package/dist/card-oembed-fallback.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-oembed-fallback.mjs","sources":["../src/plugins/card/oembed-fallback.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport { CORSError, fetchOEmbedData } from '../oembed/fetcher';\nimport { generateHtml } from '../oembed/html-generator';\nimport type { OEmbedPluginOptions, OEmbedProvider } from '../oembed/types';\nimport type { CardOEmbedFallback } from './types';\n\nconst isProviderNotFoundError = (error: unknown): boolean => {\n  return (\n    error instanceof Error &&\n    error.message.startsWith('No oEmbed provider found for URL:')\n  );\n};\n\n/**\n * Create an oEmbed fallback renderer for card blocks\n * @param providerList - List of oEmbed providers to use\n * @param options - Configuration options for oEmbed fetching/rendering\n * @returns Fallback renderer for card plugin\n */\nexport const createCardOEmbedFallback = (\n  providerList: OEmbedProvider[],\n  options: OEmbedPluginOptions = {}\n): CardOEmbedFallback => {\n  const { maxRedirects = 5, timeoutEachRedirect = 10000 } = options;\n\n  return {\n    render: async (url, context) => {\n      try {\n        const oembedData = await fetchOEmbedData(\n          url,\n          maxRedirects,\n          timeoutEachRedirect,\n          context,\n          providerList\n        );\n        return generateHtml(oembedData, url, options);\n      } catch (error) {\n        if (error instanceof CORSError || isProviderNotFoundError(error)) {\n          return undefined;\n        }\n        throw error;\n      }\n    },\n  };\n};\n"],"names":[],"mappings":";;;;;;;;;;;AAUA,MAAM,0BAA0B,CAAC,UAA4B;AAC3D,SACE,iBAAiB,SACjB,MAAM,QAAQ,WAAW,mCAAmC;AAEhE;AAQO,MAAM,2BAA2B,CACtC,cACA,UAA+B,OACR;AACvB,QAAM,EAAE,eAAe,GAAG,sBAAsB,QAAU;AAE1D,SAAO;AAAA,IACL,QAAQ,OAAO,KAAK,YAAY;AAC9B,UAAI;AACF,cAAM,aAAa,MAAM;AAAA,UACvB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAEF,eAAO,aAAa,YAAY,KAAK,OAAO;AAAA,MAC9C,SAAS,OAAO;AACd,YAAI,iBAAiB,aAAa,wBAAwB,KAAK,GAAG;AAChE,iBAAO;AAAA,QACT;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EAAA;AAEJ;"}