@aicayzer/inkkit 0.0.18 → 0.1.1

package/dist/callouts.js

@@ -1,288 +0,0 @@
-import { $node, $prose, $remark } from '@milkdown/kit/utils';
-import { editorLabels } from './labels.js';
-import { singleLine } from './references.js';
-import { remarkCtx } from '@milkdown/kit/core';
-import { Plugin, PluginKey } from '@milkdown/kit/prose/state';
-import { defaultHandlers } from 'mdast-util-to-markdown';
-const kinds = new Set(['NOTE', 'TIP', 'IMPORTANT', 'WARNING', 'CAUTION']);
-export function revealCalloutAncestors(view, position) {
-    const node = view.domAtPos(position).node;
-    let element = node instanceof HTMLElement ? node : node.parentElement;
-    while (element && element !== view.dom) {
-        if (element.getAttribute('data-inkkit-folded') === 'true')
-            element
-                .querySelector(':scope > .inkkit-callout-header > [data-inkkit-callout-toggle]')
-                ?.click();
-        element = element.parentElement;
-    }
-}
-function plainHeader(processor, source) {
-    const node = processor.parse(source).children[0];
-    return node?.type === 'paragraph' &&
-        node.children.length === 1 &&
-        node.children[0]?.type === 'text'
-        ? node.children[0].value
-        : undefined;
-}
-const calloutHandler = (untyped, parent, state, info) => {
-    const node = untyped;
-    const body = defaultHandlers.blockquote({ type: 'blockquote', children: node.children }, parent, state, info);
-    const title = node.titleSource ?? node.title;
-    return `> ${node.marker}${node.fold}${title ? ` ${title}` : ''}\n${body}`;
-};
-function remarkCallouts() {
-    const processor = this;
-    const data = this.data();
-    (data.toMarkdownExtensions ??= []).push({
-        handlers: { inkkitCallout: calloutHandler },
-    });
-    return (tree, file) => {
-        const source = String(file.value).replace(/^\uFEFF/, '');
-        const visit = (node) => {
-            if (node.type === 'blockquote') {
-                const start = node.position?.start.offset, end = node.position?.end.offset;
-                const raw = start == null || end == null ? '' : source.slice(start, end);
-                const header = /^>[ \t]*([\s\S]*?)(?:\r?\n|$)/.exec(raw)?.[1] ?? '';
-                if (header.startsWith('[!')) {
-                    const match = /^(\[!([A-Za-z]+)\])([+-]?)(?:[ \t]+([^\r\n]*))?$/.exec(header);
-                    const first = node.children[0];
-                    const decodedHeader = plainHeader(processor, header);
-                    // A bounded header occupies one unformatted line; other variants stay source.
-                    if (!match ||
-                        decodedHeader == null ||
-                        !kinds.has(match[2].toUpperCase()) ||
-                        /^[+-](?:[ \t]|[+-])/.test(match[4] ?? '') ||
-                        first?.type !== 'paragraph' ||
-                        first.children[0]?.type !== 'text')
-                        return {
-                            type: 'inkkitLiteral',
-                            value: raw,
-                            position: node.position,
-                        };
-                    const text = first.children[0];
-                    // Entities can decode to newlines without ending the authored header line.
-                    const ending = /^\r?\n/.exec(text.value.slice(decodedHeader.length));
-                    const lineEnd = ending ? decodedHeader.length : -1;
-                    if (lineEnd < 0 && first.children.length > 1)
-                        return {
-                            type: 'inkkitLiteral',
-                            value: raw,
-                            position: node.position,
-                        };
-                    const children = [...node.children];
-                    if (lineEnd >= 0) {
-                        const remaining = text.value.slice(lineEnd + ending[0].length);
-                        const firstStart = text.position?.start.offset;
-                        const token = firstStart == null
-                            ? ''
-                            : source.slice(firstStart, text.position?.end.offset);
-                        const boundary = /\r?\n[ \t]*>[ \t]?/.exec(token);
-                        const bodyStart = firstStart == null || !boundary
-                            ? undefined
-                            : firstStart + boundary.index + boundary[0].length;
-                        const point = bodyStart == null
-                            ? undefined
-                            : {
-                                line: source.slice(0, bodyStart).split('\n').length,
-                                column: bodyStart - source.lastIndexOf('\n', bodyStart - 1),
-                                offset: bodyStart,
-                            };
-                        children[0] = {
-                            ...first,
-                            children: [
-                                ...(remaining
-                                    ? [
-                                        {
-                                            ...text,
-                                            value: remaining,
-                                            position: point && text.position
-                                                ? { start: point, end: text.position.end }
-                                                : undefined,
-                                        },
-                                    ]
-                                    : []),
-                                ...first.children.slice(1),
-                            ],
-                        };
-                    }
-                    else
-                        children.shift();
-                    if (!children.length)
-                        children.push({ type: 'paragraph', children: [] });
-                    return {
-                        type: 'inkkitCallout',
-                        kind: match[2].toUpperCase(),
-                        marker: match[1],
-                        fold: match[3],
-                        title: decodedHeader
-                            .slice(header.length - (match[4]?.length ?? 0))
-                            .trimEnd(),
-                        titleSource: match[4]?.trimEnd() ?? '',
-                        children: children.map((child) => visit(child)),
-                        position: node.position,
-                    };
-                }
-            }
-            if ('children' in node)
-                node.children = node.children.map((child) => visit(child));
-            return node;
-        };
-        tree.children = tree.children.map((node) => visit(node));
-    };
-}
-export const remarkCalloutsPlugin = $remark('inkkitCallouts', () => remarkCallouts);
-export const calloutSchema = $node('inkkit_callout', (ctx) => ({
-    group: 'block',
-    content: 'block+',
-    defining: true,
-    attrs: {
-        kind: { default: 'NOTE' },
-        marker: { default: '[!NOTE]' },
-        fold: { default: '' },
-        title: { default: '' },
-        titleSource: { default: null },
-    },
-    parseDOM: [
-        {
-            tag: 'blockquote[data-inkkit-callout]',
-            priority: 100,
-            contentElement: '.inkkit-callout-body',
-            getAttrs: (dom) => {
-                const kind = (dom.getAttribute('data-inkkit-callout') ?? '').toUpperCase();
-                const marker = dom.getAttribute('data-inkkit-marker') ?? `[!${kind}]`;
-                const fold = dom.getAttribute('data-inkkit-fold') ?? '';
-                // A title read from the visible text is written with its punctuation
-                // escaped, so it reads back as the same plain text.
-                const visibleTitle = singleLine(dom.querySelector('.inkkit-callout-title')?.textContent ?? '').trim();
-                const titleSource = dom.getAttribute('data-inkkit-title') ??
-                    visibleTitle.replace(/[!-/:-@[-`{-~]/g, '\\$&');
-                const titleHeader = plainHeader(ctx.get(remarkCtx), `${marker} ${titleSource}`);
-                if (!kinds.has(kind) ||
-                    !/^\[![A-Za-z]+\]$/.test(marker) ||
-                    marker.slice(2, -1).toUpperCase() !== kind ||
-                    !['', '+', '-'].includes(fold) ||
-                    /[\r\n]/.test(titleSource) ||
-                    titleHeader == null)
-                    return false;
-                return {
-                    kind,
-                    marker,
-                    fold,
-                    title: titleHeader.slice(marker.length + 1).trimEnd(),
-                    titleSource,
-                };
-            },
-        },
-    ],
-    toDOM: (node) => [
-        'blockquote',
-        {
-            class: 'inkkit-callout',
-            'data-inkkit-callout': node.attrs.kind,
-            'data-inkkit-marker': node.attrs.marker,
-            'data-inkkit-fold': node.attrs.fold,
-            'data-inkkit-title': node.attrs.titleSource ?? node.attrs.title,
-        },
-        [
-            'strong',
-            { class: 'inkkit-callout-title' },
-            node.attrs.title ||
-                String(node.attrs.kind)
-                    .toLowerCase()
-                    .replace(/^./, (letter) => letter.toUpperCase()),
-        ],
-        ['div', { class: 'inkkit-callout-body' }, 0],
-    ],
-    parseMarkdown: {
-        match: (node) => node.type === 'inkkitCallout',
-        runner(state, node, type) {
-            state.openNode(type, {
-                kind: node.kind,
-                marker: node.marker,
-                fold: node.fold,
-                title: node.title,
-                titleSource: node.titleSource,
-            });
-            state.next(node.children);
-            state.closeNode();
-        },
-    },
-    toMarkdown: {
-        match: (node) => node.type.name === 'inkkit_callout',
-        runner(state, node) {
-            state.openNode('inkkitCallout', undefined, { ...node.attrs });
-            state.next(node.content);
-            state.closeNode();
-        },
-    },
-}));
-export const calloutView = $prose((ctx) => new Plugin({
-    key: new PluginKey('inkkitCalloutView'),
-    props: {
-        nodeViews: {
-            inkkit_callout(node, view) {
-                const dom = document.createElement('blockquote');
-                dom.className = 'inkkit-callout';
-                dom.setAttribute('data-inkkit-callout', String(node.attrs.kind));
-                const header = document.createElement('div');
-                header.className = 'inkkit-callout-header';
-                header.contentEditable = 'false';
-                const title = document.createElement('strong');
-                title.className = 'inkkit-callout-title';
-                const contentDOM = document.createElement('div');
-                contentDOM.className = 'inkkit-callout-body';
-                let folded = node.attrs.fold === '-';
-                const button = document.createElement('button');
-                button.type = 'button';
-                button.setAttribute('data-inkkit-callout-toggle', '');
-                const render = () => {
-                    title.textContent =
-                        node.attrs.title ||
-                            String(node.attrs.kind)
-                                .toLowerCase()
-                                .replace(/^./, (letter) => letter.toUpperCase());
-                    dom.setAttribute('data-inkkit-folded', String(folded));
-                    view.dom.dispatchEvent(new Event('inkkit-media-policy'));
-                    button.hidden = !node.attrs.fold;
-                    button.setAttribute('aria-expanded', String(!folded));
-                    button.setAttribute('aria-label', `${folded ? editorLabels(ctx).expandCallout : editorLabels(ctx).collapseCallout} ${title.textContent}`);
-                    button.textContent = folded
-                        ? editorLabels(ctx).expandCallout
-                        : editorLabels(ctx).collapseCallout;
-                };
-                const toggle = () => {
-                    folded = !folded;
-                    render();
-                };
-                button.addEventListener('click', toggle);
-                button.addEventListener('keydown', (event) => {
-                    if (event.key === 'Enter' || event.key === ' ') {
-                        event.preventDefault();
-                        event.stopPropagation();
-                        toggle();
-                    }
-                });
-                header.append(title, button);
-                dom.append(header, contentDOM);
-                render();
-                return {
-                    dom,
-                    contentDOM,
-                    update(next) {
-                        if (next.type !== node.type)
-                            return false;
-                        if (next.attrs.fold !== node.attrs.fold)
-                            folded = next.attrs.fold === '-';
-                        node = next;
-                        render();
-                        return true;
-                    },
-                    stopEvent: (event) => header.contains(event.target),
-                    ignoreMutation: (mutation) => mutation.type !== 'selection' &&
-                        !contentDOM.contains(mutation.target),
-                };
-            },
-        },
-    },
-}));
-export const callouts = [calloutSchema, calloutView].flat();

package/dist/clipboard.d.ts

@@ -1,11 +0,0 @@
-import { type Fragment, type Schema } from '@milkdown/kit/prose/model';
-import type { ClipboardOutput, DocumentContext, ImageAdapter, FileAdapter } from './types.js';
-export interface ClipboardContent {
-    text: string;
-    html: string;
-}
-export declare function clipboardText(content: Fragment, missingImages?: ReadonlySet<string>, fileDescriptions?: ReadonlyMap<object, string>): string;
-export declare function clipboardContent(content: Fragment, schema: Schema): ClipboardContent;
-export declare const visibleClipboard: import("@milkdown/kit/utils").$Prose;
-/** Export a frozen document fragment; presentation URLs never enter the clipboard. */
-export declare function portableClipboard(content: Fragment, schema: Schema, markdown: string, adapter: ImageAdapter | undefined, context: DocumentContext, completeDiagrams?: ReadonlySet<string>, files?: FileAdapter, signal?: AbortSignal): Promise<ClipboardOutput>;

package/dist/clipboard.js

@@ -1,261 +0,0 @@
-import { DOMSerializer, } from '@milkdown/kit/prose/model';
-import { Plugin, PluginKey } from '@milkdown/kit/prose/state';
-import { $prose } from '@milkdown/kit/utils';
-import { shareableFragment } from './comments.js';
-import { diagramImage } from './mermaid.js';
-import { fileReference } from './linked-syntax.js';
-import { portableFile, portableFileImage } from './portable-files.js';
-import { withFileSignal } from './files.js';
-// Clipboard text is the visible document, not Markdown serialization: escaping
-// punctuation or trailing spaces here leaks source syntax into other apps.
-export function clipboardText(content, missingImages = new Set(), fileDescriptions = new Map()) {
-    content = shareableFragment(content);
-    const blocks = [];
-    content.forEach((node) => {
-        if (node.type.name !== 'reference_definition')
-            blocks.push(nodeText(node, missingImages, fileDescriptions));
-    });
-    const inline = content.firstChild?.isInline ?? false;
-    return blocks.join(inline ? '' : '\n\n');
-}
-function nodeText(node, missingImages, fileDescriptions) {
-    if (node.type.name === 'inkkit_wiki_link')
-        return String(node.attrs.label || node.attrs.target || 'Link');
-    if (node.type.name === 'inkkit_callout')
-        return `${node.attrs.title ||
-            String(node.attrs.kind)
-                .toLowerCase()
-                .replace(/^./, (letter) => letter.toUpperCase())}\n${clipboardText(node.content, missingImages, fileDescriptions)}`;
-    if (node.type.name === 'reference_definition')
-        return '';
-    if (node.type.name === 'footnote_reference')
-        return `[${node.attrs.label}]`;
-    if (node.type.name === 'footnote_definition')
-        return `[${node.attrs.label}] ${clipboardText(node.content, missingImages, fileDescriptions)}`;
-    if (node.isText)
-        return node.text ?? '';
-    if (node.type.name === 'hardbreak' || node.type.name === 'hard_break')
-        return '\n';
-    if (node.type.name === 'bullet_list' || node.type.name === 'ordered_list') {
-        const items = [];
-        node.forEach((item, _offset, index) => {
-            const marker = node.type.name === 'ordered_list'
-                ? `${Number(node.attrs.order ?? 1) + index}. `
-                : '- ';
-            const task = item.attrs.checked == null ? '' : item.attrs.checked ? '[x] ' : '[ ] ';
-            const prefix = marker + task;
-            const indent = ' '.repeat(marker.length);
-            const blocks = [];
-            item.forEach((child, _childOffset, childIndex) => {
-                const text = nodeText(child, missingImages, fileDescriptions);
-                const nestedList = child.type.name === 'bullet_list' ||
-                    child.type.name === 'ordered_list';
-                const lines = text.split('\n');
-                const indented = lines
-                    .map((line, lineIndex) => childIndex === 0 && lineIndex === 0 ? prefix + line : indent + line)
-                    .join('\n');
-                // Nested lists follow their parent directly; subsequent paragraphs keep
-                // their blank line and every continuation stays inside its list item.
-                blocks.push((childIndex > 0 && !nestedList ? '\n' : '') + indented);
-            });
-            items.push(blocks.length ? blocks.join('\n') : prefix.trimEnd());
-        });
-        return items.join('\n');
-    }
-    if (node.type.name === 'image') {
-        const description = fileDescriptions.get(node.attrs);
-        if (description != null)
-            return description;
-        const alt = fileReference(node).label || 'Image';
-        return missingImages.has(String(node.attrs.src ?? ''))
-            ? `[${alt}: image unavailable]`
-            : alt;
-    }
-    if (node.type.name === 'table') {
-        const rows = [];
-        node.forEach((row) => {
-            const cells = [];
-            row.forEach((cell) => cells.push(clipboardText(cell.content, missingImages, fileDescriptions)));
-            rows.push(cells.join('\t'));
-        });
-        return rows.join('\n');
-    }
-    return clipboardText(node.content, missingImages, fileDescriptions);
-}
-export function clipboardContent(content, schema) {
-    content = shareableFragment(content);
-    const container = document.createElement('div');
-    const serializer = DOMSerializer.fromSchema(schema);
-    // Construct image elements without a source so detached clipboard DOM never
-    // fetches authored references or temporary presentation URLs.
-    const safe = new DOMSerializer({
-        ...serializer.nodes,
-        inkkit_wiki_link: (node) => [
-            'span',
-            String(node.attrs.label || node.attrs.target || 'Link'),
-        ],
-        image: (node) => [
-            'img',
-            {
-                alt: String(node.attrs.alt ?? ''),
-                title: String(node.attrs.title ?? ''),
-            },
-        ],
-    }, serializer.marks);
-    container.append(safe.serializeFragment(content));
-    for (const definition of container.querySelectorAll('[data-inkkit-reference-definition]'))
-        definition.remove();
-    for (const reference of container.querySelectorAll('[data-inkkit-footnote-reference]')) {
-        reference.removeAttribute('tabindex');
-        reference.removeAttribute('role');
-    }
-    for (const definition of container.querySelectorAll('[data-inkkit-footnote-definition]')) {
-        const label = document.createElement('span');
-        label.textContent = `[${definition.getAttribute('data-inkkit-label')}] `;
-        definition.prepend(label);
-    }
-    return { text: clipboardText(content), html: container.innerHTML };
-}
-export const visibleClipboard = $prose(() => new Plugin({
-    key: new PluginKey('visibleClipboard'),
-    props: {
-        clipboardTextSerializer: (slice) => clipboardText(slice.content),
-    },
-}));
-/** Export a frozen document fragment; presentation URLs never enter the clipboard. */
-export async function portableClipboard(content, schema, markdown, adapter, context, completeDiagrams, files, signal = new AbortController().signal) {
-    signal.throwIfAborted();
-    content = shareableFragment(content);
-    const base = clipboardContent(content, schema);
-    const container = document.createElement('div');
-    container.innerHTML = base.html;
-    const images = [];
-    const references = [];
-    const fileDescriptions = new Map();
-    content.descendants((node) => {
-        if (node.type.name === 'image')
-            references.push(node);
-    });
-    const captured = [...container.querySelectorAll('img')].map((element, index) => {
-        const node = references[index];
-        const reference = String(node?.attrs.src ?? '');
-        const { label: authoredAlt, width } = fileReference(node);
-        const alt = authoredAlt || 'Image';
-        if (width != null && width > 0)
-            element.setAttribute('width', String(Math.min(4096, width)));
-        element.removeAttribute('src');
-        element.removeAttribute('srcset');
-        return { element, node, reference, alt };
-    });
-    await Promise.all(captured.map(async ({ element, node, reference, alt }, index) => {
-        let label = alt;
-        element.setAttribute('data-inkkit-image-slot', String(index));
-        element.setAttribute('data-inkkit-authored-image-slot', String(index));
-        try {
-            const file = files
-                ? await portableFile(node, files, context, signal)
-                : undefined;
-            if (file && file.presentation.kind !== 'image') {
-                const fallback = document.createElement('span');
-                fallback.textContent = file.description;
-                element.replaceWith(fallback);
-                fileDescriptions.set(node.attrs, file.description);
-                return;
-            }
-            label = file?.label || alt;
-            if (!files && !adapter)
-                throw new Error('The image is unavailable.');
-            const input = file
-                ? await portableFileImage(file, files, adapter, context, signal)
-                : await withFileSignal(adapter.exportImage(reference, { ...context }), signal);
-            signal.throwIfAborted();
-            const image = { ...input, bytes: new Uint8Array(input.bytes) };
-            if (!/^image\/(png|jpeg|gif|webp|avif|bmp|tiff)$/i.test(image.mimeType))
-                throw new Error('The image format cannot be exported.');
-            let binary = '';
-            for (const byte of image.bytes)
-                binary += String.fromCharCode(byte);
-            const portable = `data:${image.mimeType};base64,${btoa(binary)}`;
-            element.setAttribute('src', portable);
-            element.setAttribute('alt', label);
-            fileDescriptions.set(node.attrs, label);
-            images[index] = { reference, alt: label, image };
-        }
-        catch (error) {
-            signal.throwIfAborted();
-            const message = error instanceof Error ? error.message : 'The image is unavailable.';
-            const warning = document.createElement('span');
-            warning.textContent = `[${label}: image unavailable]`;
-            element.replaceWith(warning);
-            fileDescriptions.set(node.attrs, warning.textContent);
-            images[index] = { reference, alt: label, error: message };
-        }
-    }));
-    const diagrams = [];
-    for (const code of container.querySelectorAll('pre[data-language="mermaid"] > code')) {
-        const source = code.textContent ?? '';
-        if (completeDiagrams && !completeDiagrams.has(source))
-            continue;
-        const result = { source };
-        diagrams.push(result);
-        try {
-            const image = await withFileSignal(diagramImage(source), signal);
-            let binary = '';
-            for (const byte of image.bytes)
-                binary += String.fromCharCode(byte);
-            const figure = document.createElement('figure');
-            figure.setAttribute('data-inkkit-mermaid', source);
-            const fence = code.parentElement.getAttribute('data-inkkit-fence');
-            if (fence)
-                figure.setAttribute('data-inkkit-fence', fence);
-            const element = document.createElement('img');
-            element.src = `data:image/png;base64,${btoa(binary)}`;
-            element.alt = `Mermaid diagram: ${source}`;
-            figure.append(element);
-            code.parentElement.replaceWith(figure);
-            result.image = image;
-        }
-        catch (error) {
-            signal.throwIfAborted();
-            result.error =
-                error instanceof Error
-                    ? error.message
-                    : 'The diagram could not be exported.';
-            const warning = document.createElement('p');
-            warning.setAttribute('data-inkkit-diagram-error', '');
-            warning.textContent = `Diagram unavailable: ${result.error}`;
-            code.parentElement.before(warning);
-        }
-    }
-    // Native attachment slots follow DOM order, including generated diagrams.
-    const orderedImages = [];
-    for (const element of container.querySelectorAll('img')) {
-        const diagram = element.closest('[data-inkkit-mermaid]');
-        const item = diagram
-            ? {
-                reference: '',
-                alt: element.alt,
-                image: diagrams.find((entry) => entry.source === diagram.getAttribute('data-inkkit-mermaid')).image,
-            }
-            : images[Number(element.getAttribute('data-inkkit-image-slot'))];
-        element.setAttribute('data-inkkit-image-slot', String(orderedImages.length));
-        orderedImages.push(item);
-    }
-    // Scriptable links and event attributes are not part of semantic rich text.
-    for (const element of container.querySelectorAll('*')) {
-        for (const attribute of [...element.attributes])
-            if (attribute.name.startsWith('on') ||
-                ((attribute.name === 'href' || attribute.name === 'src') &&
-                    /^javascript:/i.test(attribute.value)))
-                element.removeAttribute(attribute.name);
-    }
-    const missing = new Set(images.filter((image) => image?.error).map((image) => image.reference));
-    signal.throwIfAborted();
-    return {
-        text: clipboardText(content, missing, fileDescriptions),
-        html: container.innerHTML,
-        markdown,
-        images: [...orderedImages, ...images.filter((image) => image?.error)],
-        diagrams,
-    };
-}

package/dist/code-fences.d.ts

@@ -1,8 +0,0 @@
-import { type Options } from 'mdast-util-to-markdown';
-import type { Ctx } from '@milkdown/kit/ctx';
-import type { Node as ProseNode } from '@milkdown/kit/prose/model';
-export declare const remarkCodeFences: import("@milkdown/kit/utils").$Remark<"codeFences", unknown>;
-export declare const preservingCodeBlocks: import("@milkdown/kit/utils").$NodeSchema<"code_block">;
-export declare const fencedCodeHandler: NonNullable<Options['handlers']>['code'];
-export declare function restoreCodeEndings(ctx: Ctx, doc: ProseNode, markdown: string): string;
-export declare function finalCodeEnding(doc: ProseNode): string | undefined;