@openleaf-editor/ui 0.1.0-beta.0 → 0.1.0-beta.2

package/dist/content-css.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Load content CSS so the canvas matches the published site.
+ *
+ * OpenLeaf has no iframe. Host typography already inherits into the document,
+ * which is the point of skipping Shadow DOM. This helper is for an extra
+ * stylesheet the published template uses -- a CMS "styles.css" -- that is not
+ * on the admin page. Selectors are scoped under the editor canvas so a rule
+ * written for `p.lead` cannot restyle the rest of the admin chrome.
+ */
+export declare function scopeContentCss(css: string): string;
+export declare function loadContentCss(doc: Document, urls: readonly string[]): Promise<void>;
+export declare function contentCssUrls(value: string | null): string[];
+//# sourceMappingURL=content-css.d.ts.map

package/dist/content-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-css.d.ts","sourceRoot":"","sources":["../src/content-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcnD;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB1F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAM7D"}

package/dist/content-css.js

@@ -0,0 +1,57 @@
+/**
+ * Load content CSS so the canvas matches the published site.
+ *
+ * OpenLeaf has no iframe. Host typography already inherits into the document,
+ * which is the point of skipping Shadow DOM. This helper is for an extra
+ * stylesheet the published template uses -- a CMS "styles.css" -- that is not
+ * on the admin page. Selectors are scoped under the editor canvas so a rule
+ * written for `p.lead` cannot restyle the rest of the admin chrome.
+ */
+export function scopeContentCss(css) {
+    return css.replace(/(^|})(\s*)([^@{}][^{]*)\{/g, (full, brace, space, selector) => {
+        if (selector.trim().startsWith('@'))
+            return full;
+        const scoped = selector
+            .split(',')
+            .map((part) => {
+            const trimmed = part.trim();
+            if (!trimmed)
+                return part;
+            if (trimmed.startsWith('.ol-editor') || trimmed.startsWith('.ol-content'))
+                return trimmed;
+            return `.ol-editor .ol-content .ProseMirror ${trimmed}`;
+        })
+            .join(', ');
+        return `${brace}${space}${scoped}{`;
+    });
+}
+export async function loadContentCss(doc, urls) {
+    if (typeof CSSStyleSheet === 'undefined' || !('adoptedStyleSheets' in Document.prototype)) {
+        console.warn('@openleaf-editor/ui: content CSS could not be adopted in this browser. ' +
+            'Link the published stylesheet on the host page instead.');
+        return;
+    }
+    for (const url of urls) {
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const css = scopeContentCss(await response.text());
+            const sheet = new CSSStyleSheet();
+            sheet.replaceSync(css);
+            doc.adoptedStyleSheets = [...doc.adoptedStyleSheets, sheet];
+        }
+        catch (error) {
+            console.warn(`@openleaf-editor/ui: content CSS at "${url}" could not be loaded.`, error);
+        }
+    }
+}
+export function contentCssUrls(value) {
+    if (!value)
+        return [];
+    return value
+        .split(/[, ]+/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=content-css.js.map

package/dist/content-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-css.js","sourceRoot":"","sources":["../src/content-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,IAAI,EAAE,KAAa,EAAE,KAAa,EAAE,QAAgB,EAAE,EAAE;QACxG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAChD,MAAM,MAAM,GAAG,QAAQ;aACpB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAC3B,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAA;YACzB,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,OAAO,OAAO,CAAA;YACzF,OAAO,uCAAuC,OAAO,EAAE,CAAA;QACzD,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAa,EAAE,IAAuB;IACzE,IAAI,OAAO,aAAa,KAAK,WAAW,IAAI,CAAC,CAAC,oBAAoB,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1F,OAAO,CAAC,IAAI,CACV,yEAAyE;YACvE,yDAAyD,CAC5D,CAAA;QACD,OAAM;IACR,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YAC5D,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;YAClD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;YACjC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YACtB,GAAG,CAAC,kBAAkB,GAAG,CAAC,GAAG,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,wCAAwC,GAAG,wBAAwB,EACnE,KAAK,CACN,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO,KAAK;SACT,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC"}

package/dist/dialog.d.ts

@@ -6,9 +6,23 @@
  * is a few hundred lines that would then owe real screen reader testing to be
  * worth anything, and the native element is already tested by the browser
  * vendors. Choosing it is the single biggest accessibility win available here.
+ *
+ * ## Why committing is asynchronous
+ *
+ * The image dialog uploads a file, and an upload is the one thing in this editor
+ * that can take five seconds and fail for a reason the author needs to read. So
+ * the form's commit step returns a promise: the dialog stays open while it runs,
+ * disables its buttons, says what it is doing in a polite live region, and on
+ * failure shows the message and keeps everything the author typed.
+ *
+ * The alternative -- close the dialog, upload in the background, report through a
+ * toast -- loses the alt text they wrote when the upload fails, and makes the
+ * retry a whole new dialog.
  */
+import { type ImageUploadResult } from './upload.js';
 export interface LinkResult {
     href: string;
+    title: string | null;
     target: string | null;
     rel: string | null;
 }
@@ -16,10 +30,81 @@ export interface ImageResult {
     src: string;
     /** `''` means explicitly decorative. `null` is never returned. */
     alt: string;
+    title: string | null;
+    /** Intrinsic size, when an uploader reported one. */
+    width: string | null;
+    height: string | null;
+    className: string | null;
+    align: 'left' | 'right' | 'center' | null;
+    caption: string | null;
+}
+export interface FieldOption {
+    value: string;
+    label: string;
+}
+export interface FieldSpec {
+    name: string;
+    label: string;
+    type?: string;
+    value?: string;
+    required?: boolean;
+    hint?: string;
+    /** For `type: 'file'`: the accept list. */
+    accept?: string;
+    /** When set, the field is a `<select>` rather than an input. */
+    options?: readonly FieldOption[];
+    /**
+     * The field this control writes into when it changes.
+     *
+     * A chooser that only *contributed* its value could never change a field that
+     * was already filled in: editing a link or an image prefills the address, so
+     * picking from the list lost to it every time and the list worked only for new
+     * insertions. Writing into the field it fills keeps one source of truth, and
+     * shows the author what they picked so they can still edit it.
+     */
+    fills?: string;
 }
+export declare function ensureDialogStyles(doc: Document): void;
+export interface PromptFormOptions {
+    extraCheckbox?: {
+        name: string;
+        label: string;
+        hint?: string;
+        checked?: boolean;
+    };
+    note?: string;
+    busyLabel?: string;
+}
+/**
+ * A generic modal form, used by table property dialogs and anything else that
+ * is a handful of labelled fields rather than a specialised prompt.
+ */
+export declare function promptFields<T>(doc: Document, title: string, fields: FieldSpec[], options: PromptFormOptions, commit: (values: Record<string, string>, files: Record<string, File | undefined>) => Promise<{
+    value: T;
+} | {
+    error: string;
+}> | {
+    value: T;
+} | {
+    error: string;
+}): Promise<T | null>;
 export declare function promptForLink(doc: Document, existing?: {
     href?: string;
+    title?: string | null;
     target?: string | null;
-}): Promise<LinkResult | null>;
-export declare function promptForImage(doc: Document): Promise<ImageResult | null>;
+}, host?: HTMLElement): Promise<LinkResult | null>;
+export interface ImagePromptOptions {
+    file?: File;
+    upload?: (file: File) => Promise<ImageUploadResult>;
+    host?: HTMLElement;
+    existing?: {
+        src?: string;
+        alt?: string | null;
+        title?: string | null;
+        className?: string | null;
+        align?: 'left' | 'right' | 'center' | null;
+        caption?: string | null;
+    };
+}
+export declare function promptForImage(doc: Document, options?: ImagePromptOptions): Promise<ImageResult | null>;
 //# sourceMappingURL=dialog.d.ts.map

package/dist/dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../src/dialog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAA;CACZ;AA4ND,wBAAsB,aAAa,CACjC,GAAG,EAAE,QAAQ,EACb,QAAQ,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnD,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoC5B;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAuC/E"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../src/dialog.ts"],"names":[],"mappings":"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"}