@plitzi/plitzi-builder 0.36.2 → 0.37.1

package/CHANGELOG.md

@@ -1,5 +1,97 @@
 # @plitzi/plitzi-builder
 
+## 0.37.1
+
+### Patch Changes
+
+- v0.37.1
+- Updated dependencies
+  - @plitzi/plitzi-sdk@0.37.1
+  - @plitzi/sdk-auth@0.37.1
+  - @plitzi/sdk-authoring@0.37.1
+  - @plitzi/sdk-dev-tools@0.37.1
+  - @plitzi/sdk-elements@0.37.1
+  - @plitzi/sdk-event-bridge@0.37.1
+  - @plitzi/sdk-interactions@0.37.1
+  - @plitzi/sdk-navigation@0.37.1
+  - @plitzi/sdk-plugins@0.37.1
+  - @plitzi/sdk-schema@0.37.1
+  - @plitzi/sdk-shared@0.37.1
+  - @plitzi/sdk-style@0.37.1
+  - @plitzi/sdk-variables@0.37.1
+
+## 0.37.0
+
+### Minor Changes
+
+- - A `button` takes a `title`: shown as a tooltip, and its accessible name when it has no text of its own — an
+    icon-only button without one was announced as nothing. The builder's settings offer it as "Tooltip". The JSON export
+    is two files, `schema.json` and `style.json`, shown as tabs; each group of changes in the export folds away.
+
+  - `BindingTransformer.params` is `Record<string, string | number | boolean>`: a param the builder draws as a checkbox
+    (`styleVariant`'s `append`) is stored as the boolean it is and read as one, so the type now says so. The MCP compares
+    such a param with its catalog options as text. A `container` may be an `li`, for the rows of a list. The export
+    keeps every element id with `keepIds`, and the header's Publish dialog opens wider.
+
+  - **The builder exports the space on screen — on paid plans.** **Export** in the header opens a wide dialog: the
+    format as tabs (TypeScript in one file, TypeScript with a file per page as a `.zip`, or JSON), generated as soon as
+    it is picked, shown read-only in CodeMirror — beside a file list when there are several — with one row of actions,
+    **Copy** and **Download**. What the export tidied is a one-line note that unfolds into readable groups. On the free
+    plan the dialog explains what export is instead; the server refuses the code with a 402 (`limit: 'spaceExport'`)
+    whatever the builder shows. `useSpaceExport` is the one way into it, for anything else that needs the space as files.
+
+  - **A space document can be read back into code.** `specFromSpace(documents)` turns a `{ schema, style }` pair — a
+    builder export, a seed checked in as JSON — into the `SpaceSpec` that authors it, and `specToSource(spec, { exportName })`
+    writes that spec out as the TypeScript a person would write: one factory call per element, the attributes a type
+    already defaults to left out, the longhands the document stores written back as `padding: 10px 20px`, and every class
+    something names as a `styles()` declaration held in a variable. `split: true` writes one file per page and per layout.
+    `compareSpaces(expected, actual)` proves the round trip: it lists every way two pairs render differently — the tree,
+    the attributes, the rules that apply to each element whatever its selector is called, bindings, flows, pages, layouts
+    and settings — and nothing else. A selector used by one element becomes that element's own `css`; one shared, or
+    spelled out anywhere in the document (a `customCss` rule, a template), stays a class under its own name; an element id
+    nothing refers to is left out and derived again.
+
+    What an older builder left behind is repaired on the way, and every repair is reported in `corrections` rather than
+    made silently: element types that no longer exist (`navbar` → a `list` laid out in a row, `navbarItem` → `listItem`),
+    a hover stored as a class of its own (`card:hover`) folded into the class, fields and attributes no component reads,
+    a setting nothing reads, a link `target` of `_blank` (the component adds the underscore, so it rendered as `__blank`),
+    `null` or an empty list where an attribute is unset, a binding to a source nothing publishes, a flow with a step that
+    runs nothing, and a global callback registered on the wrong module. A CSS property the style editor cannot hold is
+    kept in `customCss` under the same selector, so the page still renders it.
+
+  - **What a spec can say grew to what a document holds.** A selector carries its states and variants beside its rules —
+    `styles('card', { css, states: { hover }, variants: { active } })`, and `states` on an element's own `css` — and the
+    selector cache is now written by `processSelector`, the function the style editor writes it with. An element type's
+    defaults (`elements`) take states, variants, per-breakpoint rules and `slots` for its other selectors (a modal's
+    `rootContainer`). A space declares `layouts` — shells that pages render inside, named by `layout: { id, slot }` on a
+    page or on another layout, with the slot checked to be inside the shell — and a page takes `keepState` and
+    `stateStorage`. `visible: false` starts an element hidden for a flow to reveal, and `loadStrategy` is carried through.
+    An element's own selector never takes the name of a declared class any more, however that class happens to be called.
+
+  - `elementAttributeNames` lists, as data, the attributes each built-in element can be authored with — `null` for one
+    that takes any. It is generated from the elements' attribute types (`yarn generate:attribute-names`) and a type test
+    fails when the two disagree. `defaultAttributes(type)` and `defaultLabel(type)` expose what a factory fills in.
+
+  - `CustomAttributes` accepts any attribute, because the component a custom element's `renderType` names reads its own
+    attributes off it; and `FormControlAttributes` declares `previewError`, which `withFieldValue` reads.
+
+### Patch Changes
+
+- Updated dependencies
+  - @plitzi/plitzi-sdk@0.37.0
+  - @plitzi/sdk-auth@0.37.0
+  - @plitzi/sdk-authoring@0.37.0
+  - @plitzi/sdk-dev-tools@0.37.0
+  - @plitzi/sdk-elements@0.37.0
+  - @plitzi/sdk-event-bridge@0.37.0
+  - @plitzi/sdk-interactions@0.37.0
+  - @plitzi/sdk-navigation@0.37.0
+  - @plitzi/sdk-plugins@0.37.0
+  - @plitzi/sdk-schema@0.37.0
+  - @plitzi/sdk-shared@0.37.0
+  - @plitzi/sdk-style@0.37.0
+  - @plitzi/sdk-variables@0.37.0
+
 ## 0.36.2
 
 ### Patch Changes

package/dist/index.html

@@ -56,10 +56,10 @@
       render(
         'plitzi',
         {
-          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCJdLCJpc3MiOiJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJhdWQiOlsiaHR0cHM6Ly9wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAxIiwiaHR0cHM6Ly9hcGkucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zc3IucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9tY3AucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hdXRoLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly8xMjcuMC4wLjE6NTMwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6NTE4MCJdLCJzY29wZSI6InNwYWNlOnJlbmRlciIsImlhdCI6MTc4OTY1OTYzNCwianRpIjoiYWY3YjM1YjNiN2FjOGYzZSIsIm5iZiI6MTc4OTY1OTYzNH0.WL79EN1eBNg74LzHQA7yQijE3Y1sPfHxurAHOG2Eyf0',
+          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCJdLCJpc3MiOiJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJhdWQiOlsiaHR0cHM6Ly9wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAxIiwiaHR0cHM6Ly9hcGkucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zc3IucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9tY3AucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hdXRoLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly8xMjcuMC4wLjE6NTMwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6NTE4MCJdLCJzY29wZSI6InNwYWNlOnJlbmRlciIsImlhdCI6MTc4OTg0OTYyMywianRpIjoiMmM0ZTRkNDI1NzEzMTI4YyIsIm5iZiI6MTc4OTg0OTYyM30.VKxz7K9A8tvKnCwWLnB02NgAQY7Oftr6NzAXH8v4nsU',
           // The actor. Without it the builder loads and every write is refused, since authorization is
           // can(actor, space, permission). Both halves come from `yarn token 1 --user admin` in plitzi-sdk-server.
-          userKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiaXNzIjoiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiYXVkIjpbImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vYXBpLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vbWNwLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXV0aC5wbGl0emkubG9jYWwiLCJodHRwOi8vMTI3LjAuMC4xOjUzMDAiLCJodHRwOi8vbG9jYWxob3N0OjUxODAiXSwic2NvcGUiOiJ1c2VyIiwiZXhwIjoxNzg5NzIzMDE5LCJpYXQiOjE3ODk2MzY2MTksImp0aSI6IjhlZjJmZmFmOGM0M2M3NmYiLCJuYmYiOjE3ODk2MzY2MTl9.sqmBSkAm3J2VSarPRvk2ChTHQ38lqOAOVKszW_MLPu0',
+          userKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiaXNzIjoiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiYXVkIjpbImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vYXBpLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vbWNwLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXV0aC5wbGl0emkubG9jYWwiLCJodHRwOi8vMTI3LjAuMC4xOjUzMDAiLCJodHRwOi8vbG9jYWxob3N0OjUxODAiXSwic2NvcGUiOiJ1c2VyIiwiZXhwIjoxNzg5OTA1NDg3LCJpYXQiOjE3ODk4MTkwODcsImp0aSI6ImQyZjAwNTE1ZTFiMzk1YzEiLCJuYmYiOjE3ODk4MTkwODd9.SGs05mrxeKWgi34XZ--vG_qtkwk8Pw7R2KEt5EU6rpc',
           environment: 'main',
           server: {
             basePath: '',

package/dist/modules/App/helpers/modalSizes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * How wide the header's dialogs open, as settings for `showModal`.
+ *
+ * The modal's own card stops at `max-w-lg`, which suits a confirmation and cramps anything else: a form with a
+ * revision list, a domain and a credential needs room to read, and a code viewer needs room for a 120-column file.
+ */
+export declare const FORM_MODAL: {
+    className: {
+        card: string;
+    };
+};
+export declare const WIDE_MODAL: {
+    className: {
+        card: string;
+    };
+};

package/dist/modules/DataSource/models/BindingForm/BindingForm.d.ts

@@ -8,7 +8,7 @@ export declare const bindingForm: z.ZodObject<{
     when: z.ZodOptional<z.ZodAny>;
     transformers: z.ZodArray<z.ZodObject<{
         action: z.ZodString;
-        params: z.ZodRecord<z.ZodString, z.ZodString>;
+        params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/modules/Export/ExportSpace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A copy of the space on screen, as JSON or as the code that authors it.
+ *
+ * Generated as soon as a format is picked and shown before anything is saved, so the code can be copied straight into
+ * an editor, or downloaded, from the one row of actions above it. A paid-plan capability: on the free plan the dialog
+ * says what export is instead.
+ */
+declare const ExportSpace: () => import("react").JSX.Element;
+export default ExportSpace;

package/dist/modules/Export/components/ExportChanges/ExportChanges.d.ts

@@ -0,0 +1,13 @@
+import { SpecCorrection } from '@plitzi/sdk-authoring';
+export type ExportChangesProps = {
+    corrections: SpecCorrection[];
+};
+/**
+ * What the export tidied while reading the space, one change per row.
+ *
+ * Grouped by kind under a heading that folds it away, every change on its own line with the names in it set in code —
+ * so where one ends and the next begins is never a question. Nothing here is wrong with the space: these are the
+ * leftovers an older builder wrote that today's code has no word for.
+ */
+declare const ExportChanges: ({ corrections }: ExportChangesProps) => import("react").JSX.Element;
+export default ExportChanges;

package/dist/modules/Export/components/ExportChanges/components/ExportChangeGroup/ExportChangeGroup.d.ts

@@ -0,0 +1,7 @@
+import { CorrectionGroup } from '../../../../helpers/repairs';
+export type ExportChangeGroupProps = {
+    group: CorrectionGroup;
+};
+/** One kind of change: a heading that folds it away, and every change of that kind on its own row. */
+declare const ExportChangeGroup: ({ group }: ExportChangeGroupProps) => import("react").JSX.Element;
+export default ExportChangeGroup;

package/dist/modules/Export/components/ExportChanges/components/ExportChangeGroup/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportChangeGroup } from './ExportChangeGroup';
+export * from './ExportChangeGroup';
+export default ExportChangeGroup;

package/dist/modules/Export/components/ExportChanges/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportChanges } from './ExportChanges';
+export * from './ExportChanges';
+export default ExportChanges;

package/dist/modules/Export/components/ExportLocked/ExportLocked.d.ts

@@ -0,0 +1,7 @@
+export type ExportLockedProps = {
+    /** The plan the workspace is on, to say what it is being compared with. */
+    planName?: string;
+};
+/** What export is and which plans have it — in place of the result, for a workspace on the free plan. */
+declare const ExportLocked: ({ planName }: ExportLockedProps) => import("react").JSX.Element;
+export default ExportLocked;

package/dist/modules/Export/components/ExportLocked/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportLocked } from './ExportLocked';
+export * from './ExportLocked';
+export default ExportLocked;

package/dist/modules/Export/components/ExportToolbar/ExportToolbar.d.ts

@@ -0,0 +1,13 @@
+import { ExportFormat } from '../../helpers/exportFormats';
+export type ExportToolbarProps = {
+    format: ExportFormat;
+    /** What the shown code can be copied as, and the file the export downloads as — absent until there is one. */
+    fileName?: string;
+    canCopy: boolean;
+    onChangeFormat: (format: ExportFormat) => void;
+    onCopy: () => void;
+    onDownload: () => void;
+};
+/** The format on the left, what can be done with the result on the right — one row, one place for every action. */
+declare const ExportToolbar: ({ format, fileName, canCopy, onChangeFormat, onCopy, onDownload }: ExportToolbarProps) => import("react").JSX.Element;
+export default ExportToolbar;

package/dist/modules/Export/components/ExportToolbar/components/ExportFormatButton/ExportFormatButton.d.ts

@@ -0,0 +1,8 @@
+import { ExportFormat, ExportFormatOption } from '../../../../helpers/exportFormats';
+export type ExportFormatButtonProps = {
+    option: ExportFormatOption;
+    selected: boolean;
+    onSelect: (format: ExportFormat) => void;
+};
+declare const ExportFormatButton: ({ option, selected, onSelect }: ExportFormatButtonProps) => import("react").JSX.Element;
+export default ExportFormatButton;

package/dist/modules/Export/components/ExportToolbar/components/ExportFormatButton/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportFormatButton } from './ExportFormatButton';
+export * from './ExportFormatButton';
+export default ExportFormatButton;

package/dist/modules/Export/components/ExportToolbar/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportToolbar } from './ExportToolbar';
+export * from './ExportToolbar';
+export default ExportToolbar;

package/dist/modules/Export/components/ExportViewer/ExportViewer.d.ts

@@ -0,0 +1,16 @@
+import { SpecCorrection } from '@plitzi/sdk-authoring';
+export type ExportViewerProps = {
+    /** Every file of the export, by path: one shows alone, a few as tabs, many beside a list to pick from. */
+    paths: string[];
+    selectedPath?: string;
+    content?: string;
+    /** What the export tidied on the way; a view of its own when there is any. */
+    corrections: SpecCorrection[];
+    mode: 'js' | 'json';
+    theme: 'light' | 'dark';
+    loading: boolean;
+    onSelectPath: (path: string) => void;
+};
+/** The export itself, read-only — the code, and on a view of its own, what was tidied to write it. */
+declare const ExportViewer: ({ paths, selectedPath, content, corrections, mode, theme, loading, onSelectPath }: ExportViewerProps) => import("react").JSX.Element;
+export default ExportViewer;

package/dist/modules/Export/components/ExportViewer/components/ExportFileFolder/ExportFileFolder.d.ts

@@ -0,0 +1,9 @@
+import { FileFolder } from '../../../../helpers/exportFiles';
+export type ExportFileFolderProps = {
+    folder: FileFolder;
+    selectedPath?: string;
+    onSelect: (path: string) => void;
+};
+/** A folder of the export — the layouts, the pages — that folds away, its files indented under a guide line. */
+declare const ExportFileFolder: ({ folder, selectedPath, onSelect }: ExportFileFolderProps) => import("react").JSX.Element;
+export default ExportFileFolder;

package/dist/modules/Export/components/ExportViewer/components/ExportFileFolder/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportFileFolder } from './ExportFileFolder';
+export * from './ExportFileFolder';
+export default ExportFileFolder;

package/dist/modules/Export/components/ExportViewer/components/ExportFileItem/ExportFileItem.d.ts

@@ -0,0 +1,11 @@
+export type ExportFileItemProps = {
+    path: string;
+    /** What the file is shown as — its name inside a folder, since the folder already says where it is. */
+    label: string;
+    /** Inside a folder: indented under it, beside the guide line the folder draws. */
+    nested?: boolean;
+    selected: boolean;
+    onSelect: (path: string) => void;
+};
+declare const ExportFileItem: ({ path, label, nested, selected, onSelect }: ExportFileItemProps) => import("react").JSX.Element;
+export default ExportFileItem;

package/dist/modules/Export/components/ExportViewer/components/ExportFileItem/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportFileItem } from './ExportFileItem';
+export * from './ExportFileItem';
+export default ExportFileItem;

package/dist/modules/Export/components/ExportViewer/components/ExportFileTab/ExportFileTab.d.ts

@@ -0,0 +1,8 @@
+export type ExportFileTabProps = {
+    path: string;
+    selected: boolean;
+    onSelect: (path: string) => void;
+};
+/** One file of a small export — the schema, the style — as a tab, where a list of two would be a waste of a column. */
+declare const ExportFileTab: ({ path, selected, onSelect }: ExportFileTabProps) => import("react").JSX.Element;
+export default ExportFileTab;

package/dist/modules/Export/components/ExportViewer/components/ExportFileTab/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportFileTab } from './ExportFileTab';
+export * from './ExportFileTab';
+export default ExportFileTab;

package/dist/modules/Export/components/ExportViewer/components/ExportFileTree/ExportFileTree.d.ts

@@ -0,0 +1,8 @@
+export type ExportFileTreeProps = {
+    paths: string[];
+    selectedPath?: string;
+    onSelect: (path: string) => void;
+};
+/** The export's files as the folders they are written into: the space's own files first, then each folder. */
+declare const ExportFileTree: ({ paths, selectedPath, onSelect }: ExportFileTreeProps) => import("react").JSX.Element;
+export default ExportFileTree;

package/dist/modules/Export/components/ExportViewer/components/ExportFileTree/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportFileTree } from './ExportFileTree';
+export * from './ExportFileTree';
+export default ExportFileTree;

package/dist/modules/Export/components/ExportViewer/components/ExportViewTab/ExportViewTab.d.ts

@@ -0,0 +1,12 @@
+export type ExportView = 'code' | 'changes';
+export type ExportViewTabProps = {
+    view: ExportView;
+    label: string;
+    icon: string;
+    /** Shown beside the label as a count, when there is one. */
+    count?: number;
+    selected: boolean;
+    onSelect: (view: ExportView) => void;
+};
+declare const ExportViewTab: ({ view, label, icon, count, selected, onSelect }: ExportViewTabProps) => import("react").JSX.Element;
+export default ExportViewTab;

package/dist/modules/Export/components/ExportViewer/components/ExportViewTab/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportViewTab } from './ExportViewTab';
+export * from './ExportViewTab';
+export default ExportViewTab;

package/dist/modules/Export/components/ExportViewer/index.d.ts

@@ -0,0 +1,3 @@
+import { default as ExportViewer } from './ExportViewer';
+export * from './ExportViewer';
+export default ExportViewer;

package/dist/modules/Export/helpers/editor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CodeMirror's wrappers take the whole height they are given, so the editor scrolls inside the viewer instead of
+ * growing past it — the viewer clips, and a clipped editor cannot be scrolled at all.
+ */
+export declare const FULL_HEIGHT_EDITOR: {
+    root: string;
+    inputContainer: string;
+};

package/dist/modules/Export/helpers/exportFiles.d.ts

@@ -0,0 +1,43 @@
+import { ExportFormat } from './exportFormats';
+import { SpaceDifference, SpecCorrection } from '@plitzi/sdk-authoring';
+/**
+ * A space, exported: the files it became and what happened on the way.
+ *
+ * Kept as plain data rather than as a download, because what is done with it differs by caller — copied into an editor,
+ * saved as a file, handed to a deployment — and none of them should have to export the space again to do it.
+ */
+export type SpaceExport = {
+    format: ExportFormat;
+    /** What the export is saved as: the one file, or the archive holding several. */
+    fileName: string;
+    /** Source files by path. One entry unless the export was split. */
+    files: Record<string, string>;
+    /** What the export repaired in the space's documents. Empty for a JSON export, which changes nothing. */
+    corrections: SpecCorrection[];
+    /** How the exported code would differ from the space — each one a repair `corrections` names. */
+    differences: SpaceDifference[];
+};
+/** The one file of a single-file export, which is what can be shown and copied. */
+export declare const singleFileOf: (spaceExport: SpaceExport) => string | undefined;
+/** The export as one file to save: the file itself, or a zip of every file in its folder structure. */
+export declare const exportBlob: (spaceExport: SpaceExport) => Promise<Blob>;
+/** Saves a blob through the browser's own download, under the given name. */
+export declare const downloadBlob: (fileName: string, blob: Blob) => void;
+/** The files in reading order: the space first, then what sits beside it, then each folder's files by name. */
+export declare const orderedPaths: (files: Record<string, string>) => string[];
+/** How an export's files are offered: as tabs when there are a few, as a list when there are many, not at all when one. */
+export declare const fileNavigationOf: (paths: string[]) => "none" | "tabs" | "list";
+export type FileFolder = {
+    name: string;
+    paths: string[];
+};
+/**
+ * An export's files as a tree one folder deep — which is every shape an export has: the files beside the space, then a
+ * folder for the layouts and one for the pages. Files keep their full path; the folder is what they are shown under.
+ */
+export declare const fileTreeOf: (paths: string[]) => {
+    files: string[];
+    folders: FileFolder[];
+};
+/** The name a file is shown by inside its folder. */
+export declare const fileNameOf: (path: string) => string;

package/dist/modules/Export/helpers/exportFiles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Export/helpers/exportFormats.d.ts

@@ -0,0 +1,11 @@
+/** What a space can be exported as. */
+export type ExportFormat = 'authoring' | 'authoring-split' | 'json';
+export type ExportFormatOption = {
+    value: ExportFormat;
+    label: string;
+    icon: string;
+    description: string;
+};
+export declare const EXPORT_FORMATS: readonly ExportFormatOption[];
+export declare const DEFAULT_EXPORT_FORMAT: ExportFormat;
+export declare const descriptionOf: (format: ExportFormat) => string;

package/dist/modules/Export/helpers/repairs.d.ts

@@ -0,0 +1,28 @@
+import { SpecCorrection } from '@plitzi/sdk-authoring';
+export declare const repairLabel: (code: string) => string;
+/** Removed, corrected or kept: what the reader DID, which is what the icon beside a kind of repair says. */
+export declare const repairIcon: (code: string) => string;
+/** A stretch of a message; `key` is its place in the message, which is fixed — a message is never reordered. */
+export type MessagePart = {
+    key: string;
+    text: string;
+    code: boolean;
+};
+/**
+ * A repair message, with the names in it — `"listItem-bOPK"`, `"_blank"` — set apart from the prose around them.
+ *
+ * The reader quotes every name it mentions, so the quotes are what mark them: the parts between them are what a person
+ * scans a list of repairs for, and reading them as code is what tells one from the sentence around it.
+ */
+export declare const messageParts: (message: string) => MessagePart[];
+export type CorrectionGroup = {
+    code: string;
+    label: string;
+    total: number;
+    messages: {
+        text: string;
+        count: number;
+    }[];
+};
+/** The repairs by kind, in the order each kind first appeared — the same repair made several times listed once. */
+export declare const groupCorrections: (corrections: SpecCorrection[]) => CorrectionGroup[];

package/dist/modules/Export/helpers/repairs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Export/hooks/useExportSession.d.ts

@@ -0,0 +1,22 @@
+import { ExportFormat } from '../helpers/exportFormats';
+/**
+ * One visit to the export dialog: the format picked, what each format came to, and which file is on screen.
+ *
+ * A format is generated the first time it is shown and kept, so going back to one already seen is instant — the dialog
+ * is short-lived, and nothing in it edits the space. Nothing is generated for a free plan: the dialog says what export
+ * is instead, and the server would refuse the code anyway.
+ */
+declare const useExportSession: () => {
+    format: ExportFormat;
+    changeFormat: (next: ExportFormat) => void;
+    planName: string | undefined;
+    locked: boolean;
+    loading: boolean;
+    error: string;
+    spaceExport: import('..').SpaceExport | undefined;
+    paths: string[];
+    selectedPath: string;
+    selectPath: import('react').Dispatch<import('react').SetStateAction<string | undefined>>;
+    content: string | undefined;
+};
+export default useExportSession;

package/dist/modules/Export/hooks/useSpaceExport.d.ts

@@ -0,0 +1,23 @@
+import { SpaceExport } from '../helpers/exportFiles';
+import { ExportFormat } from '../helpers/exportFormats';
+/** What an export came to: the files, or why there are none — the plan, or anything else. */
+export type SpaceExportResult = {
+    ok: true;
+    spaceExport: SpaceExport;
+} | {
+    ok: false;
+    error: string;
+    requiresPaidPlan: boolean;
+};
+/**
+ * Exports the space the builder is showing, as it is on screen.
+ *
+ * The documents are the builder's own — the schema and the style it is editing — so the export is what the person sees,
+ * not the last copy something else saved. JSON is written here, from data the builder already holds; the code is
+ * written by the server (`/utils/transform-to-authoring`), which holds the reader, the formatter, the check that the
+ * code authors the same space, and the plan gate. Anything that needs the space as files calls this.
+ */
+declare const useSpaceExport: () => {
+    exportSpace: (format: ExportFormat) => Promise<SpaceExportResult>;
+};
+export default useSpaceExport;

package/dist/modules/Export/index.d.ts

@@ -0,0 +1,7 @@
+import { default as ExportSpace } from './ExportSpace';
+export * from './ExportSpace';
+export * from './helpers/exportFiles';
+export * from './helpers/exportFormats';
+export { default as useSpaceExport } from './hooks/useSpaceExport';
+export type { SpaceExportResult } from './hooks/useSpaceExport';
+export default ExportSpace;

package/dist/modules/Segments/SegmentsReducer.d.ts

@@ -1,4 +1,4 @@
-import { DisplayMode, Element, ReducerActionOrigin, SchemaVariable, Segment, Style, StyleItem, TagType, DropPosition, StyleVariableCategory, StyleVariableValue, StyleCategory, StyleState } from '@plitzi/sdk-shared';
+import { DisplayMode, Element, ReducerActionOrigin, SchemaVariable, Segment, Style, StyleItem, TagType, DropPosition, StyleVariableCategory, StyleVariableValue, StyleCategory, StyleTarget } from '@plitzi/sdk-shared';
 export declare const SegmentsActions: {
     readonly SEGMENTS_ADD: "SEGMENTS_ADD";
     readonly SEGMENTS_UPDATE: "SEGMENTS_UPDATE";
@@ -80,23 +80,15 @@ export type SegmentsReducerActions = ({
     selectorType: TagType;
     path?: StyleCategory;
     value?: StyleItem['attributes'];
-    params: {
-        componentType?: string;
-        styleSelector?: string;
-        styleState?: StyleState;
-        styleVariant?: string;
-    };
+    params: StyleTarget;
 } & SegmentsReducerActionsBase) | ({
     type: 'SEGMENTS_STYLE_UPDATE_SELECTOR';
     displayMode: DisplayMode;
     selector: string;
     path?: StyleCategory;
     value?: StyleItem['attributes'];
-    params: {
-        componentType?: string;
+    params: StyleTarget & {
         styleSelector: string;
-        styleState?: StyleState;
-        styleVariant?: string;
     };
 } & SegmentsReducerActionsBase) | ({
     type: 'SEGMENTS_STYLE_REMOVE_SELECTOR';

package/dist/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@plitzi/plitzi-builder",
-  "version": "0.36.2",
+  "version": "0.37.1",
   "homepage": "./",
   "license": "AGPL-3.0",
   "files": [
@@ -32,6 +32,7 @@ declare const _default: {
     "@plitzi/plitzi-sdk": "workspace:*",
     "@plitzi/plitzi-ui": "^1.6.21",
     "@plitzi/sdk-auth": "workspace:*",
+    "@plitzi/sdk-authoring": "workspace:*",
     "@plitzi/sdk-dev-tools": "workspace:*",
     "@plitzi/sdk-elements": "workspace:*",
     "@plitzi/sdk-event-bridge": "workspace:*",