@webx-ui/module-blocks 0.6.4 → 0.7.0

package/dist/BlockStage.d.ts

@@ -1,19 +1,26 @@
 /**
- * The block on its own, at a chosen width: a desktop scaled down to fit the column, a tablet
- * or a phone at one to one. The document is the block, its styles, its script and the
- * runtime, and nothing of the panel — an iframe, so the block's CSS stays the block's.
+ * The block as it will stand on the site, at a chosen width: a desktop scaled down to fit the
+ * column, a tablet or a phone at one to one.
+ *
+ * With `stage` the frame is a page of the site — its layout, header, footer and styles, with
+ * an empty place for the block — loaded once; every change after that swaps the block and its
+ * styles in place, so the site around it does not redraw under the editor's typing. Without
+ * it (a server older than the stage) the frame is the block on a bare document, as before.
  */
 type __VLS_Props = {
     html: string;
     styles: string;
     script?: string | null;
     runtime?: string | null;
+    /** The address of the stage page; null draws the block on a bare document. */
+    stage?: string | null;
     loading?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     script: string | null;
     loading: boolean;
     runtime: string | null;
+    stage: string | null;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     box: HTMLDivElement;
     frame: HTMLIFrameElement;

package/dist/frame.d.ts

@@ -55,6 +55,32 @@ export interface FrameBinding {
 export declare function bindFrame(doc: Document, handlers: {
     select: (key: string | null) => void;
 }): FrameBinding;
+/**
+ * The same picture without the choosing: nothing in the page navigates, submits or is dragged
+ * away. What the block editor's stage needs — the site's header is full of links, and one
+ * click on them would leave the frame on another page of the site with the block gone.
+ */
+export declare function freezeFrame(doc: Document): FrameBinding;
+/** The key the stage draws its block under — `StageController::KEY` on the server. */
+export declare const STAGE_KEY = "sample";
+/** The `<style>` of the stage the block's styles go into — `StageController::STYLES`. */
+export declare const STAGE_STYLES = "wx-stage-styles";
+/**
+ * Put a block on the stage page: its styles into the stage's `<style>`, its markup between the
+ * markers. False when the page has no place for it — a layout that dropped its slot.
+ *
+ * The script is not here on purpose: a script registered in a page cannot be taken back, so
+ * a new one means a new page (see `mountScript`).
+ */
+export declare function fillStage(doc: Document, input: {
+    html: string;
+    styles: string;
+}): boolean;
+/**
+ * Run a block's script in the page: `webx.block()` registers it and mounts what is already
+ * there. Added as an element, since that is what makes a browser run it.
+ */
+export declare function mountScript(doc: Document, script: string): void;
 export interface StageInput {
     html: string;
     styles: string;