@webx-ui/module-blocks 0.8.9 → 0.9.1

package/dist/schema.d.ts

@@ -1,4 +1,5 @@
 import { ScreenNode } from '@webx-ui/schema';
+import { BlockKind } from './types';
 /**
  * A block's schema names a field by `id` alone — the id is the key in the values, and the
  * variable in the template. The renderer binds a field by `name`. So before a schema is
@@ -20,3 +21,25 @@ export declare function usageWords(count: number, t: (key: string, params?: Reco
  * a group of its own and no words for it sees the id, capitalised, which is honest.
  */
 export declare function groupLabel(id: string, t: (key: string, params?: Record<string, string | number>) => string): string;
+/** What a type is; a server older than components sends no `kind`, and everything was a block. */
+export declare function kindOf(type: {
+    kind?: BlockKind;
+}): BlockKind;
+/**
+ * How many types call a component, in words — the component's "on 3 pages". Counted in types
+ * rather than pages on purpose (§3.10): the pages behind every parent are expensive to count and
+ * say little, while the parents are what a change to the component can break.
+ */
+export declare function callerWords(count: number, t: (key: string, params?: Record<string, string | number>) => string): string;
+/** The fields of a schema through its layout, flat — the variables a template gets. */
+export declare function schemaFields(schema: ScreenNode[]): ScreenNode[];
+/**
+ * The tag that calls a type, with every input it takes — what the help under a component's
+ * template offers to copy.
+ *
+ * `wx-data` is passed from code, so it is bound (`:card="$card"`); a plain field shows its sample
+ * when that is a word (`tone="accent"`) and is bound otherwise. Declared slots stand in the body;
+ * with none, the tag closes itself — the default `$slot` is there all the same, and a body shown
+ * for it would read as something the component needs.
+ */
+export declare function callTag(slug: string, schema: ScreenNode[], sample?: Record<string, unknown>, fallback?: string | null): string;

package/dist/style.css

@@ -1 +1 @@
-.wx-block-checks[data-v-e56947a8]{display:flex;flex-direction:column;gap:var(--wx-space-4);padding:var(--wx-space-8) var(--wx-space-12);font-size:var(--wx-font-size-sm);border-block-start:1px solid var(--wx-border-muted)}.wx-block-checks__line[data-v-e56947a8]{display:flex;gap:var(--wx-space-8);align-items:flex-start}.wx-block-checks__line .wx-icon[data-v-e56947a8]{flex:none;margin-block-start:2px}.is-ok[data-v-e56947a8]{color:var(--wx-text-muted)}.is-ok .wx-icon[data-v-e56947a8]{color:var(--wx-color-success)}.is-warning[data-v-e56947a8]{color:var(--wx-color-warning)}.is-error[data-v-e56947a8]{color:var(--wx-color-danger)}.wx-block-history[data-v-42c6b7ad]{display:flex;flex-direction:column}.wx-block-history__ghost[data-v-42c6b7ad]{padding:var(--wx-space-10) var(--wx-space-12)}.wx-block-history__row[data-v-42c6b7ad]{display:flex;align-items:center;gap:var(--wx-space-12);padding:var(--wx-space-10) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted);flex-wrap:wrap}.wx-block-history__row[data-v-42c6b7ad]:last-child{border-block-end:0}.wx-block-history__number[data-v-42c6b7ad]{width:40px;font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-sm);color:var(--wx-text-muted)}.wx-block-history__who[data-v-42c6b7ad]{display:flex;flex-direction:column;flex:1;min-width:160px}.wx-block-stage[data-v-3185ee45]{display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);overflow:hidden}.wx-block-stage__bar[data-v-3185ee45]{display:flex;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted)}.wx-block-stage__ground[data-v-3185ee45]{padding:var(--wx-space-12);background:var(--wx-bg-subtle)}.wx-block-stage__clip[data-v-3185ee45]{overflow:hidden;margin-inline:auto;box-shadow:var(--wx-shadow-sm)}.wx-block-stage__frame[data-v-3185ee45]{display:block;border:0;background:#fff;transform-origin:top left}.wx-block-editor[data-v-22e5f784]{display:flex;flex-direction:column;gap:var(--wx-gap, var(--wx-space-16));container-type:inline-size}.wx-block-editor__ghost-head[data-v-22e5f784]{max-width:420px}.wx-block-editor__columns[data-v-22e5f784]{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}.wx-block-editor__columns.is-alone[data-v-22e5f784]{grid-template-columns:minmax(0,1fr)}.wx-block-editor__split[data-v-22e5f784]{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}@container (max-width: 1080px){.wx-block-editor__columns[data-v-22e5f784],.wx-block-editor__split[data-v-22e5f784]{grid-template-columns:minmax(0,1fr)}}.wx-block-editor__examples[data-v-22e5f784]{min-width:0}.wx-block-editor__example+.wx-block-editor__example[data-v-22e5f784]{margin-block-start:var(--wx-space-12)}.wx-block-editor__example pre[data-v-22e5f784]{margin:var(--wx-space-4) 0 0;padding:var(--wx-space-10) var(--wx-space-12);border-radius:var(--wx-radius-sm);background:var(--wx-bg-subtle);overflow-x:auto}.wx-block-editor__example code[data-v-22e5f784]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);line-height:1.6;color:var(--wx-text-default);white-space:pre}.wx-block-editor__stage[data-v-22e5f784]{position:sticky;top:var(--wx-space-12)}.wx-block-editor__pane[data-v-22e5f784]{display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);overflow:hidden}.wx-block-editor__pane[data-v-22e5f784] .wx-code-editor{border:0;border-radius:0}.wx-block-editor__sample[data-v-22e5f784]{min-width:0}.wx-block-editor__pills[data-v-22e5f784]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-6);padding:var(--wx-space-8) var(--wx-space-12);border-block-start:1px solid var(--wx-border-muted)}.wx-block-editor__pill[data-v-22e5f784]{padding:2px var(--wx-space-8);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-full);background:var(--wx-bg-surface);color:var(--wx-color-primary);font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);cursor:pointer}.wx-block-editor__pill[data-v-22e5f784]:hover:not(:disabled){border-color:var(--wx-color-primary)}.wx-block-editor__note[data-v-22e5f784]{display:flex;align-items:center;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-start:1px solid var(--wx-border-muted)}.wx-block-editor__note[data-v-22e5f784]>:first-child{flex:1 1 auto;min-width:0}.wx-block-editor__sheet[data-v-22e5f784]{min-width:0}.wx-block-editor__settings[data-v-22e5f784]{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:var(--wx-space-12) var(--wx-space-16)}.wx-block-editor__settings .is-wide[data-v-22e5f784]{grid-column:1 / -1}.wx-block-editor__danger[data-v-22e5f784]{display:flex;align-items:center;gap:var(--wx-space-12);flex-wrap:wrap}.wx-block-editor__uses[data-v-22e5f784]{padding:0;border:0;background:none;font:inherit;color:var(--wx-text-link);cursor:pointer}.wx-block-editor__uses[data-v-22e5f784]:hover{text-decoration:underline;text-underline-offset:.2em}.wx-block-editor__uses[data-v-22e5f784]:focus-visible{outline:none;border-radius:var(--wx-radius-xs);box-shadow:var(--wx-ring-focus)}.wx-block-editor__usage[data-v-22e5f784]{display:flex;flex-direction:column;gap:var(--wx-space-6)}.wx-block-editor__use[data-v-22e5f784]{display:flex;align-items:center;gap:var(--wx-space-8)}code[data-v-22e5f784]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs)}.wx-block-thumb[data-v-5ca74656]{position:relative;overflow:hidden;background:var(--wx-bg-subtle)}.wx-block-thumb__frame[data-v-5ca74656]{position:absolute;inset-block-start:0;inset-inline-start:0;border:0;transform-origin:top left;pointer-events:none;background:#fff}.wx-block-thumb__empty[data-v-5ca74656]{display:grid;place-items:center;height:100%;color:var(--wx-text-muted)}.wx-block-picker[data-v-99f4090e]{display:flex;flex-direction:column;gap:var(--wx-space-16)}.wx-block-picker__group[data-v-99f4090e]{display:flex;flex-direction:column;gap:var(--wx-space-8)}.wx-block-picker__group-title[data-v-99f4090e]{font-size:var(--wx-font-size-xs);font-weight:var(--wx-font-weight-semibold);letter-spacing:.06em;text-transform:uppercase;color:var(--wx-text-muted)}.wx-block-picker__cards[data-v-99f4090e]{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:var(--wx-space-12)}.wx-block-picker__card[data-v-99f4090e]{display:flex;flex-direction:column;padding:0;overflow:hidden;text-align:start;font:inherit;color:inherit;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);cursor:pointer}.wx-block-picker__card[data-v-99f4090e]:hover:not(:disabled),.wx-block-picker__card[data-v-99f4090e]:focus-visible{border-color:var(--wx-color-primary);outline:none}.wx-block-picker__card.is-disabled[data-v-99f4090e]{opacity:.6;cursor:not-allowed}.wx-block-picker__body[data-v-99f4090e]{display:flex;flex-direction:column;gap:var(--wx-space-4);padding:var(--wx-space-10) var(--wx-space-12)}.wx-block-picker__title[data-v-99f4090e]{font-weight:var(--wx-font-weight-semibold)}.wx-blocks-preview[data-v-398e4cef]{box-sizing:border-box;display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);overflow:clip;min-width:0}.wx-blocks-preview.is-fullscreen[data-v-398e4cef]{position:fixed;inset:0;z-index:var(--wx-z-index-overlay);border:0;border-radius:0}.wx-blocks-preview__bar[data-v-398e4cef]{display:flex;align-items:center;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted)}.wx-blocks-preview:not(.is-fullscreen) .wx-blocks-preview__bar[data-v-398e4cef]{position:sticky;top:0;z-index:1;background:var(--wx-bg-surface)}.wx-blocks-preview__label[data-v-398e4cef]{flex:1 1 0;min-width:0;font-family:var(--wx-font-family-mono)}.wx-blocks-preview__widths[data-v-398e4cef]{flex:none}.wx-blocks-preview__tools[data-v-398e4cef]{display:flex;flex:1 1 0;gap:var(--wx-space-4);align-items:center;justify-content:flex-end}.wx-blocks-preview__ground[data-v-398e4cef]{flex:1;padding:var(--wx-space-12);background:var(--wx-bg-subtle);overflow:auto;max-height:calc(100vh - 200px)}.is-fullscreen .wx-blocks-preview__ground[data-v-398e4cef]{max-height:none}.is-compact .wx-blocks-preview__ground[data-v-398e4cef]{padding-inline:0}.is-grown:not(.is-fullscreen) .wx-blocks-preview__ground[data-v-398e4cef]{overflow:visible;max-height:none}.wx-blocks-preview__clip[data-v-398e4cef]{margin-inline:auto;overflow:hidden;box-shadow:var(--wx-shadow-sm)}.wx-blocks-preview__frame[data-v-398e4cef]{display:block;border:0;background:#fff;height:min(72vh,720px);transform-origin:top left}.wx-blocks-tree[data-v-590fa1d6] .wx-sortable-list__content{min-width:0}.wx-blocks-tree__node[data-v-590fa1d6]{display:flex;flex-direction:column;gap:var(--wx-space-2);min-width:0}.wx-blocks-tree__row[data-v-590fa1d6]{display:flex;align-items:center;gap:var(--wx-space-8);padding:var(--wx-space-6) var(--wx-space-8);border:1px solid transparent;border-radius:var(--wx-radius-control);cursor:pointer}.wx-blocks-tree__row[data-v-590fa1d6]:hover{background:var(--wx-bg-subtle)}.wx-blocks-tree__row.is-selected[data-v-590fa1d6]{background:var(--wx-color-primary-soft);border-color:var(--wx-color-primary)}.wx-blocks-tree__name[data-v-590fa1d6]{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:var(--wx-font-size-sm);font-weight:var(--wx-font-weight-medium)}.wx-blocks-tree__row.is-hidden .wx-blocks-tree__name[data-v-590fa1d6]{opacity:.55}.wx-blocks-tree__flag[data-v-590fa1d6]{display:flex;color:var(--wx-text-muted)}.wx-blocks-tree__flag.is-warning[data-v-590fa1d6]{color:var(--wx-color-warning)}.wx-blocks-tree__flag.is-danger[data-v-590fa1d6]{color:var(--wx-color-danger)}.wx-blocks-tree__actions[data-v-590fa1d6]{display:flex;flex:none}@media(pointer:coarse){.wx-blocks-tree__actions[data-v-590fa1d6] .wx-actions__menu .wx-action{--wx-action-size: 32px;position:relative}.wx-blocks-tree__actions[data-v-590fa1d6] .wx-actions__menu .wx-action:after{content:"";position:absolute;inset:-6px}}.wx-blocks-tree__kids[data-v-590fa1d6]{display:flex;flex-direction:column;gap:var(--wx-space-2);margin-inline-start:var(--wx-space-14);padding-inline-start:var(--wx-space-8);border-inline-start:1px dashed var(--wx-border-default)}.wx-blocks-tree__add[data-v-590fa1d6]{width:100%;padding:var(--wx-space-6);border:1px dashed var(--wx-border-strong);border-radius:var(--wx-radius-control);background:transparent;color:var(--wx-text-muted);font:inherit;font-size:var(--wx-font-size-xs);cursor:pointer}.wx-blocks-tree__add[data-v-590fa1d6]:hover{color:var(--wx-color-primary);border-color:var(--wx-color-primary);background:var(--wx-color-primary-soft)}.wx-blocks-host[data-v-3952ee19]{container-type:inline-size}.wx-blocks[data-v-3952ee19]{display:grid;grid-template-columns:clamp(360px,34%,520px) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}.wx-blocks[data-v-3952ee19]:not(.has-preview){grid-template-columns:minmax(0,1fr)}.wx-blocks__tree[data-v-3952ee19],.wx-blocks__fields[data-v-3952ee19]{display:flex;flex-direction:column;gap:var(--wx-space-8);padding:var(--wx-space-8);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);min-width:0}.wx-blocks__panel-head[data-v-3952ee19]{display:flex;align-items:center;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-4) var(--wx-space-6)}.wx-blocks__panel-title[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-4);min-width:0;font-weight:var(--wx-font-weight-semibold)}.wx-blocks__panel-name[data-v-3952ee19]{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.wx-drawer .wx-blocks__fields .wx-blocks__panel-title[data-v-3952ee19]{display:none}.wx-blocks__trail[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-4);min-width:0;color:var(--wx-text-muted);font-weight:var(--wx-font-weight-regular);font-size:var(--wx-font-size-sm)}.wx-blocks__trail-step[data-v-3952ee19]{padding:0;border:0;background:none;color:inherit;font:inherit;cursor:pointer;white-space:nowrap}.wx-blocks__trail-step[data-v-3952ee19]:hover{color:var(--wx-text-default);text-decoration:underline}.wx-blocks__panel-extra[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-8)}.wx-blocks__form[data-v-3952ee19]{padding:var(--wx-space-6)}.wx-blocks-host:not(.is-compact) .wx-blocks__side[data-v-3952ee19]{min-width:0;position:sticky;top:var(--wx-space-12);max-height:calc(100dvh - var(--wx-space-24) - var(--wx-action-bar-room, 0px));display:flex;flex-direction:column}.wx-blocks-host:not(.is-compact) .wx-blocks__tree[data-v-3952ee19],.wx-blocks-host:not(.is-compact) .wx-blocks__fields[data-v-3952ee19]{min-height:0;overflow:clip}.wx-blocks__panel-head[data-v-3952ee19]{flex:none}.wx-blocks-host:not(.is-compact) .wx-blocks__list[data-v-3952ee19],.wx-blocks-host:not(.is-compact) .wx-blocks__form[data-v-3952ee19]{min-height:0;overflow:auto;overscroll-behavior:contain}.wx-blocks-host:not(.is-compact) .wx-blocks__list[data-v-3952ee19]{padding:var(--wx-space-2);margin:calc(-1 * var(--wx-space-2))}.wx-blocks__preview[data-v-3952ee19]{min-width:0;position:sticky;top:var(--wx-space-12)}.wx-blocks__preview[data-v-3952ee19]:has(.is-grown),.wx-blocks__preview[data-v-3952ee19]:has(.is-fullscreen){position:static}.wx-blocks__tools[data-v-3952ee19]{display:flex;align-items:center;flex-wrap:wrap;gap:var(--wx-space-8);flex:none}.wx-blocks__add[data-v-3952ee19],.wx-blocks__preview-button[data-v-3952ee19]{flex:1 1 auto;min-width:0}.wx-blocks__preview-button[data-v-3952ee19]{display:none;flex:none}.wx-blocks-host.is-compact .wx-blocks[data-v-3952ee19],.wx-blocks-host.is-compact .wx-blocks.has-preview[data-v-3952ee19]{grid-template-columns:minmax(0,1fr)}.wx-drawer .wx-blocks__tree[data-v-3952ee19],.wx-drawer .wx-blocks__fields[data-v-3952ee19]{border:0;padding:0;background:none}code[data-v-3952ee19]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);color:var(--wx-text-muted)}.wx-block-card[data-v-3d94f339]{display:flex;flex-direction:column;width:100%;padding:0;overflow:hidden;text-align:start;font:inherit;color:inherit;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);cursor:pointer}.wx-block-card[data-v-3d94f339]:hover,.wx-block-card[data-v-3d94f339]:focus-visible{border-color:var(--wx-color-primary);outline:none}.wx-block-card__body[data-v-3d94f339]{display:flex;flex-direction:column;gap:var(--wx-space-6);padding:var(--wx-space-12) var(--wx-space-14)}.wx-block-card__title[data-v-3d94f339]{font-weight:var(--wx-font-weight-semibold)}.wx-block-card__chips[data-v-3d94f339]{display:flex;flex-wrap:wrap;gap:var(--wx-space-6)}code[data-v-3d94f339]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs)}.wx-block-create[data-v-a4c0d44c]{display:flex;flex-direction:column;gap:var(--wx-space-12)}.wx-blocks-page__toolbar[data-v-553b680f]{display:flex;justify-content:flex-end}.wx-blocks-page__search[data-v-553b680f]{width:100%;max-width:280px}.wx-blocks-page__ghost[data-v-553b680f]{display:flex;flex-direction:column;overflow:hidden;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md)}.wx-blocks-page__ghost-thumb[data-v-553b680f]{border-radius:0}.wx-blocks-page__ghost-body[data-v-553b680f]{display:flex;flex-direction:column;gap:var(--wx-space-8);padding:var(--wx-space-12) var(--wx-space-14)}.wx-blocks-page__group[data-v-553b680f]{display:flex;flex-direction:column;gap:var(--wx-space-12)}.wx-blocks-page__group-title[data-v-553b680f]{font-size:var(--wx-font-size-xs);font-weight:var(--wx-font-weight-semibold);letter-spacing:.06em;text-transform:uppercase;color:var(--wx-text-muted)}.wx-blocks-page__cards[data-v-553b680f]{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:var(--wx-gap, var(--wx-space-16))}
+.wx-block-data[data-v-b994c835]{display:flex;flex-direction:column;gap:var(--wx-space-4);min-width:0}.wx-block-checks[data-v-e56947a8]{display:flex;flex-direction:column;gap:var(--wx-space-4);padding:var(--wx-space-8) var(--wx-space-12);font-size:var(--wx-font-size-sm);border-block-start:1px solid var(--wx-border-muted)}.wx-block-checks__line[data-v-e56947a8]{display:flex;gap:var(--wx-space-8);align-items:flex-start}.wx-block-checks__line .wx-icon[data-v-e56947a8]{flex:none;margin-block-start:2px}.is-ok[data-v-e56947a8]{color:var(--wx-text-muted)}.is-ok .wx-icon[data-v-e56947a8]{color:var(--wx-color-success)}.is-warning[data-v-e56947a8]{color:var(--wx-color-warning)}.is-error[data-v-e56947a8]{color:var(--wx-color-danger)}.wx-block-history[data-v-42c6b7ad]{display:flex;flex-direction:column}.wx-block-history__ghost[data-v-42c6b7ad]{padding:var(--wx-space-10) var(--wx-space-12)}.wx-block-history__row[data-v-42c6b7ad]{display:flex;align-items:center;gap:var(--wx-space-12);padding:var(--wx-space-10) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted);flex-wrap:wrap}.wx-block-history__row[data-v-42c6b7ad]:last-child{border-block-end:0}.wx-block-history__number[data-v-42c6b7ad]{width:40px;font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-sm);color:var(--wx-text-muted)}.wx-block-history__who[data-v-42c6b7ad]{display:flex;flex-direction:column;flex:1;min-width:160px}.wx-block-stage[data-v-3185ee45]{display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);overflow:hidden}.wx-block-stage__bar[data-v-3185ee45]{display:flex;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted)}.wx-block-stage__ground[data-v-3185ee45]{padding:var(--wx-space-12);background:var(--wx-bg-subtle)}.wx-block-stage__clip[data-v-3185ee45]{overflow:hidden;margin-inline:auto;box-shadow:var(--wx-shadow-sm)}.wx-block-stage__frame[data-v-3185ee45]{display:block;border:0;background:#fff;transform-origin:top left}.wx-block-editor[data-v-68672c91]{display:flex;flex-direction:column;gap:var(--wx-gap, var(--wx-space-16));container-type:inline-size}.wx-block-editor__ghost-head[data-v-68672c91]{max-width:420px}.wx-block-editor__columns[data-v-68672c91]{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}.wx-block-editor__columns.is-alone[data-v-68672c91]{grid-template-columns:minmax(0,1fr)}.wx-block-editor__split[data-v-68672c91]{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}@container (max-width: 1080px){.wx-block-editor__columns[data-v-68672c91],.wx-block-editor__split[data-v-68672c91]{grid-template-columns:minmax(0,1fr)}}.wx-block-editor__call[data-v-68672c91]{min-width:0}.wx-block-editor__call[data-v-68672c91] .wx-card__body{display:flex;flex-direction:column;gap:var(--wx-space-10)}.wx-block-editor__call-tag[data-v-68672c91]{display:flex;flex-wrap:wrap;align-items:flex-start;gap:var(--wx-space-8)}.wx-block-editor__call-tag pre[data-v-68672c91]{flex:1 1 240px;min-width:0;margin:0;padding:var(--wx-space-10) var(--wx-space-12);border-radius:var(--wx-radius-sm);background:var(--wx-bg-subtle);overflow-x:auto}.wx-block-editor__call-tag code[data-v-68672c91]{line-height:1.6;color:var(--wx-text-default);white-space:pre}.wx-block-editor__shape[data-v-68672c91]{display:flex;flex-direction:column;gap:var(--wx-space-6)}.wx-block-editor__shape-fields[data-v-68672c91]{display:grid;grid-template-columns:minmax(0,max-content) minmax(0,1fr);gap:var(--wx-space-4) var(--wx-space-12);margin:0;font-size:var(--wx-font-size-sm)}.wx-block-editor__shape-fields dt[data-v-68672c91]{display:flex;flex-wrap:wrap;align-items:baseline;gap:var(--wx-space-6)}.wx-block-editor__shape-fields dd[data-v-68672c91]{margin:0;color:var(--wx-text-muted)}.wx-block-editor__shape-type[data-v-68672c91]{font-size:var(--wx-font-size-xs);color:var(--wx-text-muted)}@container (max-width: 520px){.wx-block-editor__shape-fields[data-v-68672c91]{grid-template-columns:minmax(0,1fr)}.wx-block-editor__shape-fields dd[data-v-68672c91]{margin-block-end:var(--wx-space-6)}}.wx-block-editor__examples[data-v-68672c91]{min-width:0}.wx-block-editor__example+.wx-block-editor__example[data-v-68672c91]{margin-block-start:var(--wx-space-12)}.wx-block-editor__example pre[data-v-68672c91]{margin:var(--wx-space-4) 0 0;padding:var(--wx-space-10) var(--wx-space-12);border-radius:var(--wx-radius-sm);background:var(--wx-bg-subtle);overflow-x:auto}.wx-block-editor__example code[data-v-68672c91]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);line-height:1.6;color:var(--wx-text-default);white-space:pre}.wx-block-editor__stage[data-v-68672c91]{position:sticky;top:var(--wx-space-12)}.wx-block-editor__pane[data-v-68672c91]{display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);overflow:hidden}.wx-block-editor__pane[data-v-68672c91] .wx-code-editor{border:0;border-radius:0}.wx-block-editor__sample[data-v-68672c91]{min-width:0}.wx-block-editor__pills[data-v-68672c91]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-6);padding:var(--wx-space-8) var(--wx-space-12);border-block-start:1px solid var(--wx-border-muted)}.wx-block-editor__pill[data-v-68672c91]{padding:2px var(--wx-space-8);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-full);background:var(--wx-bg-surface);color:var(--wx-color-primary);font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);cursor:pointer}.wx-block-editor__pill[data-v-68672c91]:hover:not(:disabled){border-color:var(--wx-color-primary)}.wx-block-editor__note[data-v-68672c91]{display:flex;align-items:center;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-start:1px solid var(--wx-border-muted)}.wx-block-editor__note[data-v-68672c91]>:first-child{flex:1 1 auto;min-width:0}.wx-block-editor__sheet[data-v-68672c91]{min-width:0}.wx-block-editor__settings[data-v-68672c91]{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:var(--wx-space-12) var(--wx-space-16)}.wx-block-editor__settings .is-wide[data-v-68672c91]{grid-column:1 / -1}.wx-block-editor__danger[data-v-68672c91]{display:flex;align-items:center;gap:var(--wx-space-12);flex-wrap:wrap}.wx-block-editor__uses[data-v-68672c91]{padding:0;border:0;background:none;font:inherit;color:var(--wx-text-link);cursor:pointer}.wx-block-editor__uses[data-v-68672c91]:hover{text-decoration:underline;text-underline-offset:.2em}.wx-block-editor__uses[data-v-68672c91]:focus-visible{outline:none;border-radius:var(--wx-radius-xs);box-shadow:var(--wx-ring-focus)}.wx-block-editor__usage[data-v-68672c91]{display:flex;flex-direction:column;gap:var(--wx-space-6)}.wx-block-editor__use[data-v-68672c91]{display:flex;align-items:center;gap:var(--wx-space-8)}a.wx-block-editor__use[data-v-68672c91]{color:var(--wx-text-link);text-decoration:none}a.wx-block-editor__use[data-v-68672c91]:hover{text-decoration:underline;text-underline-offset:.2em}code[data-v-68672c91]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs)}.wx-block-thumb[data-v-5ca74656]{position:relative;overflow:hidden;background:var(--wx-bg-subtle)}.wx-block-thumb__frame[data-v-5ca74656]{position:absolute;inset-block-start:0;inset-inline-start:0;border:0;transform-origin:top left;pointer-events:none;background:#fff}.wx-block-thumb__empty[data-v-5ca74656]{display:grid;place-items:center;height:100%;color:var(--wx-text-muted)}.wx-block-picker[data-v-f175b634]{display:flex;flex-direction:column;gap:var(--wx-space-16)}.wx-block-picker__group[data-v-f175b634]{display:flex;flex-direction:column;gap:var(--wx-space-8)}.wx-block-picker__group-title[data-v-f175b634]{font-size:var(--wx-font-size-xs);font-weight:var(--wx-font-weight-semibold);letter-spacing:.06em;text-transform:uppercase;color:var(--wx-text-muted)}.wx-block-picker__cards[data-v-f175b634]{display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:var(--wx-space-12)}.wx-block-picker__card[data-v-f175b634]{display:flex;flex-direction:column;padding:0;overflow:hidden;text-align:start;font:inherit;color:inherit;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);cursor:pointer}.wx-block-picker__card[data-v-f175b634]:hover:not(:disabled),.wx-block-picker__card[data-v-f175b634]:focus-visible{border-color:var(--wx-color-primary);outline:none}.wx-block-picker__card.is-disabled[data-v-f175b634]{opacity:.6;cursor:not-allowed}.wx-block-picker__body[data-v-f175b634]{display:flex;flex-direction:column;gap:var(--wx-space-4);padding:var(--wx-space-10) var(--wx-space-12)}.wx-block-picker__title[data-v-f175b634]{font-weight:var(--wx-font-weight-semibold)}.wx-blocks-preview[data-v-398e4cef]{box-sizing:border-box;display:flex;flex-direction:column;border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);overflow:clip;min-width:0}.wx-blocks-preview.is-fullscreen[data-v-398e4cef]{position:fixed;inset:0;z-index:var(--wx-z-index-overlay);border:0;border-radius:0}.wx-blocks-preview__bar[data-v-398e4cef]{display:flex;align-items:center;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-8) var(--wx-space-12);border-block-end:1px solid var(--wx-border-muted)}.wx-blocks-preview:not(.is-fullscreen) .wx-blocks-preview__bar[data-v-398e4cef]{position:sticky;top:0;z-index:1;background:var(--wx-bg-surface)}.wx-blocks-preview__label[data-v-398e4cef]{flex:1 1 0;min-width:0;font-family:var(--wx-font-family-mono)}.wx-blocks-preview__widths[data-v-398e4cef]{flex:none}.wx-blocks-preview__tools[data-v-398e4cef]{display:flex;flex:1 1 0;gap:var(--wx-space-4);align-items:center;justify-content:flex-end}.wx-blocks-preview__ground[data-v-398e4cef]{flex:1;padding:var(--wx-space-12);background:var(--wx-bg-subtle);overflow:auto;max-height:calc(100vh - 200px)}.is-fullscreen .wx-blocks-preview__ground[data-v-398e4cef]{max-height:none}.is-compact .wx-blocks-preview__ground[data-v-398e4cef]{padding-inline:0}.is-grown:not(.is-fullscreen) .wx-blocks-preview__ground[data-v-398e4cef]{overflow:visible;max-height:none}.wx-blocks-preview__clip[data-v-398e4cef]{margin-inline:auto;overflow:hidden;box-shadow:var(--wx-shadow-sm)}.wx-blocks-preview__frame[data-v-398e4cef]{display:block;border:0;background:#fff;height:min(72vh,720px);transform-origin:top left}.wx-blocks-tree[data-v-590fa1d6] .wx-sortable-list__content{min-width:0}.wx-blocks-tree__node[data-v-590fa1d6]{display:flex;flex-direction:column;gap:var(--wx-space-2);min-width:0}.wx-blocks-tree__row[data-v-590fa1d6]{display:flex;align-items:center;gap:var(--wx-space-8);padding:var(--wx-space-6) var(--wx-space-8);border:1px solid transparent;border-radius:var(--wx-radius-control);cursor:pointer}.wx-blocks-tree__row[data-v-590fa1d6]:hover{background:var(--wx-bg-subtle)}.wx-blocks-tree__row.is-selected[data-v-590fa1d6]{background:var(--wx-color-primary-soft);border-color:var(--wx-color-primary)}.wx-blocks-tree__name[data-v-590fa1d6]{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:var(--wx-font-size-sm);font-weight:var(--wx-font-weight-medium)}.wx-blocks-tree__row.is-hidden .wx-blocks-tree__name[data-v-590fa1d6]{opacity:.55}.wx-blocks-tree__flag[data-v-590fa1d6]{display:flex;color:var(--wx-text-muted)}.wx-blocks-tree__flag.is-warning[data-v-590fa1d6]{color:var(--wx-color-warning)}.wx-blocks-tree__flag.is-danger[data-v-590fa1d6]{color:var(--wx-color-danger)}.wx-blocks-tree__actions[data-v-590fa1d6]{display:flex;flex:none}@media(pointer:coarse){.wx-blocks-tree__actions[data-v-590fa1d6] .wx-actions__menu .wx-action{--wx-action-size: 32px;position:relative}.wx-blocks-tree__actions[data-v-590fa1d6] .wx-actions__menu .wx-action:after{content:"";position:absolute;inset:-6px}}.wx-blocks-tree__kids[data-v-590fa1d6]{display:flex;flex-direction:column;gap:var(--wx-space-2);margin-inline-start:var(--wx-space-14);padding-inline-start:var(--wx-space-8);border-inline-start:1px dashed var(--wx-border-default)}.wx-blocks-tree__add[data-v-590fa1d6]{width:100%;padding:var(--wx-space-6);border:1px dashed var(--wx-border-strong);border-radius:var(--wx-radius-control);background:transparent;color:var(--wx-text-muted);font:inherit;font-size:var(--wx-font-size-xs);cursor:pointer}.wx-blocks-tree__add[data-v-590fa1d6]:hover{color:var(--wx-color-primary);border-color:var(--wx-color-primary);background:var(--wx-color-primary-soft)}.wx-blocks-host[data-v-3952ee19]{container-type:inline-size}.wx-blocks[data-v-3952ee19]{display:grid;grid-template-columns:clamp(360px,34%,520px) minmax(0,1fr);gap:var(--wx-gap, var(--wx-space-16));align-items:start}.wx-blocks[data-v-3952ee19]:not(.has-preview){grid-template-columns:minmax(0,1fr)}.wx-blocks__tree[data-v-3952ee19],.wx-blocks__fields[data-v-3952ee19]{display:flex;flex-direction:column;gap:var(--wx-space-8);padding:var(--wx-space-8);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);background:var(--wx-bg-surface);min-width:0}.wx-blocks__panel-head[data-v-3952ee19]{display:flex;align-items:center;justify-content:space-between;gap:var(--wx-space-8);padding:var(--wx-space-4) var(--wx-space-6)}.wx-blocks__panel-title[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-4);min-width:0;font-weight:var(--wx-font-weight-semibold)}.wx-blocks__panel-name[data-v-3952ee19]{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.wx-drawer .wx-blocks__fields .wx-blocks__panel-title[data-v-3952ee19]{display:none}.wx-blocks__trail[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-4);min-width:0;color:var(--wx-text-muted);font-weight:var(--wx-font-weight-regular);font-size:var(--wx-font-size-sm)}.wx-blocks__trail-step[data-v-3952ee19]{padding:0;border:0;background:none;color:inherit;font:inherit;cursor:pointer;white-space:nowrap}.wx-blocks__trail-step[data-v-3952ee19]:hover{color:var(--wx-text-default);text-decoration:underline}.wx-blocks__panel-extra[data-v-3952ee19]{display:flex;align-items:center;gap:var(--wx-space-8)}.wx-blocks__form[data-v-3952ee19]{padding:var(--wx-space-6)}.wx-blocks-host:not(.is-compact) .wx-blocks__side[data-v-3952ee19]{min-width:0;position:sticky;top:var(--wx-space-12);max-height:calc(100dvh - var(--wx-space-24) - var(--wx-action-bar-room, 0px));display:flex;flex-direction:column}.wx-blocks-host:not(.is-compact) .wx-blocks__tree[data-v-3952ee19],.wx-blocks-host:not(.is-compact) .wx-blocks__fields[data-v-3952ee19]{min-height:0;overflow:clip}.wx-blocks__panel-head[data-v-3952ee19]{flex:none}.wx-blocks-host:not(.is-compact) .wx-blocks__list[data-v-3952ee19],.wx-blocks-host:not(.is-compact) .wx-blocks__form[data-v-3952ee19]{min-height:0;overflow:auto;overscroll-behavior:contain}.wx-blocks-host:not(.is-compact) .wx-blocks__list[data-v-3952ee19]{padding:var(--wx-space-2);margin:calc(-1 * var(--wx-space-2))}.wx-blocks__preview[data-v-3952ee19]{min-width:0;position:sticky;top:var(--wx-space-12)}.wx-blocks__preview[data-v-3952ee19]:has(.is-grown),.wx-blocks__preview[data-v-3952ee19]:has(.is-fullscreen){position:static}.wx-blocks__tools[data-v-3952ee19]{display:flex;align-items:center;flex-wrap:wrap;gap:var(--wx-space-8);flex:none}.wx-blocks__add[data-v-3952ee19],.wx-blocks__preview-button[data-v-3952ee19]{flex:1 1 auto;min-width:0}.wx-blocks__preview-button[data-v-3952ee19]{display:none;flex:none}.wx-blocks-host.is-compact .wx-blocks[data-v-3952ee19],.wx-blocks-host.is-compact .wx-blocks.has-preview[data-v-3952ee19]{grid-template-columns:minmax(0,1fr)}.wx-drawer .wx-blocks__tree[data-v-3952ee19],.wx-drawer .wx-blocks__fields[data-v-3952ee19]{border:0;padding:0;background:none}code[data-v-3952ee19]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);color:var(--wx-text-muted)}.wx-block-card[data-v-ed94ea94]{display:flex;flex-direction:column;width:100%;padding:0;overflow:hidden;text-align:start;font:inherit;color:inherit;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md);cursor:pointer}.wx-block-card[data-v-ed94ea94]:hover,.wx-block-card[data-v-ed94ea94]:focus-visible{border-color:var(--wx-color-primary);outline:none}.wx-block-card__body[data-v-ed94ea94]{display:flex;flex-direction:column;gap:var(--wx-space-6);padding:var(--wx-space-12) var(--wx-space-14)}.wx-block-card__title[data-v-ed94ea94]{font-weight:var(--wx-font-weight-semibold)}.wx-block-card__chips[data-v-ed94ea94]{display:flex;flex-wrap:wrap;gap:var(--wx-space-6)}code[data-v-ed94ea94]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs)}.wx-block-create[data-v-585106f0]{display:flex;flex-direction:column;gap:var(--wx-space-12)}.wx-block-create__kinds[data-v-585106f0]{gap:var(--wx-space-10)}.wx-block-create__kinds[data-v-585106f0] .wx-radio{align-items:flex-start}.wx-block-create__kind[data-v-585106f0]{display:block;font-weight:var(--wx-font-weight-medium)}.wx-block-create__kind-help[data-v-585106f0]{display:block;font-size:var(--wx-font-size-sm);color:var(--wx-text-muted)}.wx-block-declared[data-v-3c4079a4]{display:flex;flex-direction:column;min-width:0;overflow:hidden;background:var(--wx-bg-surface);border:1px dashed var(--wx-border-strong);border-radius:var(--wx-radius-md)}.wx-block-declared__mark[data-v-3c4079a4]{display:flex;align-items:center;justify-content:center;height:120px;font-size:32px;color:var(--wx-text-muted);background:var(--wx-bg-subtle);border-block-end:1px dashed var(--wx-border-default)}.wx-block-declared__body[data-v-3c4079a4]{display:flex;flex:1 1 auto;flex-direction:column;gap:var(--wx-space-6);padding:var(--wx-space-12) var(--wx-space-14)}.wx-block-declared__title[data-v-3c4079a4]{font-weight:var(--wx-font-weight-semibold)}.wx-block-declared__actions[data-v-3c4079a4]{margin-block-start:auto;padding-block-start:var(--wx-space-4)}code[data-v-3c4079a4]{font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs)}.wx-blocks-page__toolbar[data-v-02ee019d]{display:flex;justify-content:flex-end}.wx-blocks-page__search[data-v-02ee019d]{width:100%;max-width:280px}.wx-blocks-page__ghost[data-v-02ee019d]{display:flex;flex-direction:column;overflow:hidden;background:var(--wx-bg-surface);border:1px solid var(--wx-border-default);border-radius:var(--wx-radius-md)}.wx-blocks-page__ghost-thumb[data-v-02ee019d]{border-radius:0}.wx-blocks-page__ghost-body[data-v-02ee019d]{display:flex;flex-direction:column;gap:var(--wx-space-8);padding:var(--wx-space-12) var(--wx-space-14)}.wx-blocks-page__group[data-v-02ee019d]{display:flex;flex-direction:column;gap:var(--wx-space-12)}.wx-blocks-page__group-title[data-v-02ee019d]{font-size:var(--wx-font-size-xs);font-weight:var(--wx-font-weight-semibold);letter-spacing:.06em;text-transform:uppercase;color:var(--wx-text-muted)}.wx-blocks-page__cards[data-v-02ee019d]{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:var(--wx-gap, var(--wx-space-16))}

package/dist/types.d.ts

@@ -33,6 +33,39 @@ export interface Lint {
     line: number | null;
     message: string;
 }
+/**
+ * Where a type is seen (§3.1 of the components spec). A `block` is offered in "Add a block" and
+ * its schema is the editor's form; a `component` is only ever called with `<x-webx-block>` from
+ * another template, and its schema describes what the caller hands it. Either can be called.
+ */
+export type BlockKind = 'block' | 'component';
+/** A type whose published version calls this one: the "in 2 blocks" of a component. */
+export interface BlockParent {
+    id: number;
+    slug: string;
+    title: string;
+}
+/**
+ * A place a module declared for a component (`BlockComponents::declare`): the module draws its
+ * own view there until the site customises it into a type of its own.
+ */
+export interface DeclaredComponent {
+    slug: string;
+    /** The module's id, `recipes`; its name in the panel is the manifest's title for it. */
+    module: string;
+    title: string;
+    description: string | null;
+    /** The view drawn while nothing is published under the slug. */
+    fallback: string;
+    /** Whether the site has a type of that slug already. */
+    customised: boolean;
+}
+/** One key of a data shape (`BlockShapes`): what the help under the template names. */
+export interface ShapeField {
+    name: string;
+    type: string;
+    description: string | null;
+}
 /** A block type as the section shows it. */
 export interface BlockType {
     id: number;
@@ -51,6 +84,17 @@ export interface BlockType {
     draft: BlockVersionMeta | null;
     published: BlockVersionMeta | null;
     usage_count: number;
+    kind?: BlockKind;
+    /** Slugs the template of the current version calls, sorted. */
+    uses?: string[];
+    /** Types whose published version calls this one. */
+    used_by?: BlockParent[];
+    /** The module's declaration of this slug, when there is one. Only in `GET /blocks/{id}`. */
+    declared?: DeclaredComponent | null;
+    /** The data shapes the schema's `wx-data` nodes name, by name. Only in `GET /blocks/{id}`. */
+    shape?: Record<string, {
+        fields: ShapeField[];
+    }>;
     thumbnail: BlockThumbnail | null;
     created_at: string | null;
     updated_at: string | null;
@@ -60,6 +104,7 @@ export interface BlockType {
 }
 /** What a save sends: only what changed. */
 export interface BlockInput {
+    kind?: BlockKind;
     slug?: string;
     title?: string;
     description?: string | null;
@@ -73,6 +118,11 @@ export interface BlockInput {
     content?: Partial<BlockContent>;
     comment?: string | null;
 }
+/** The section's list: the types, and the places modules declared for components. */
+export interface BlockList {
+    blocks: BlockType[];
+    declared: DeclaredComponent[];
+}
 /** An entity a type stands on. */
 export interface BlockUsage {
     model: string;
@@ -112,6 +162,12 @@ export interface PublishRefusal {
         id: number | string;
         title: string | null;
     } | null;
+    /** The calling type the draft broke, when it was a parent that failed (§3.6). */
+    parent?: BlockParent | null;
+    /** The module whose declared place failed on its own sample. */
+    declared?: string | null;
+    /** The loop publishing would close, as slugs, the first repeated at the end. */
+    cycle?: string[] | null;
 }
 /** What the server-side module says about itself in the manifest. */
 export interface BlocksMeta {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webx-ui/module-blocks",
-  "version": "0.8.9",
+  "version": "0.9.1",
   "description": "The block constructor for the WebX UI admin panel: the section where a block type is made — fields, Blade, CSS, script — and the wx-blocks field that builds a page out of them.",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
     "@codemirror/autocomplete": "^6.20.3",
     "@codemirror/state": "^6.7.4",
     "@codemirror/view": "^6.43.11",
-    "@webx-ui/core": "^0.33.2",
+    "@webx-ui/core": "^0.33.3",
     "@webx-ui/module-admin": "^0.18.0",
     "@webx-ui/schema": "^0.6.1"
   },