@plitzi/plitzi-builder 0.37.8 → 0.37.10

package/dist/modules/Interactions/components/Workflow/helpers/nodeOptions.d.ts

@@ -0,0 +1,22 @@
+import { Option, OptionGroup } from '@plitzi/plitzi-ui/Select2';
+import { InteractionCallback, InteractionCallbackType } from '@plitzi/sdk-shared';
+/** One step the picker offers, with what it takes to find its definition again once picked. */
+export type NodeOption = Exclude<Option, OptionGroup> & {
+    type: InteractionCallbackType;
+    elementId?: string;
+};
+/** A heading of the picker and the steps under it — all of one type, though one type may have several headings. */
+export type NodeOptionGroup = {
+    type: InteractionCallbackType;
+    label: string;
+    options: NodeOption[];
+};
+/** A step's value in the picker: `${elementId}_${action}`, an empty segment for a step on no element. */
+export declare const nodeOptionValue: (definition: Pick<InteractionCallback, "elementId" | "action">) => string;
+/**
+ * Every step but the triggers, under its heading: its own `group` when it has one — a space's functions are tasks to
+ * the run, and a category of their own to whoever picks one — or its type's.
+ */
+export declare const nodeOptionGroups: (definitions: readonly InteractionCallback[]) => NodeOptionGroup[];
+/** The option a node is set to, looked for under every heading of its type. */
+export declare const selectedNodeOption: (groups: readonly NodeOptionGroup[], type: InteractionCallbackType, elementId: string, action: string) => NodeOption | undefined;

package/dist/modules/Interactions/components/Workflow/helpers/nodeOptions.test.d.ts

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

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

@@ -0,0 +1,4 @@
+import { default as KeyboardKey } from './KeyboardKey';
+export * from './KeyboardKey';
+export * from './platform';
+export default KeyboardKey;

package/dist/modules/Keyboard/platform.d.ts

@@ -0,0 +1,7 @@
+export declare const isMac: boolean;
+/** The modifier a shortcut is written with on this machine: the command key on a Mac, Control everywhere else. */
+export declare const modifierKey: string;
+/** A shortcut as this machine writes it: `⌘C` on a Mac, `Ctrl+C` everywhere else. */
+export declare const withModifier: (key: string) => string;
+/** The key that removes what is selected, as its keycap reads. */
+export declare const deleteKey: string;

package/dist/modules/Network/hooks/useBuilderNetwork.d.ts

@@ -0,0 +1,12 @@
+import { BuilderMutationsMap, BuilderQueriesMap } from '@plitzi/sdk-shared';
+import { BuilderNetworkContextValue } from '@plitzi/sdk-shared/network/NetworkContext';
+import { SpaceEventMap } from '@plitzi/sdk-shared/network/spaceEvents';
+export type BuilderNetwork = BuilderNetworkContextValue<BuilderQueriesMap, BuilderMutationsMap, SpaceEventMap>;
+/**
+ * The builder's network: its queries, mutations and the space's events, typed by what the builder asks for.
+ *
+ * The context is shared with the SDK, which fills it with less, so it is typed for both. Inside the builder its value
+ * is always the one `NetworkContextProvider` writes — that is what makes this the one place it is read as that.
+ */
+declare const useBuilderNetwork: () => BuilderNetwork;
+export default useBuilderNetwork;

package/dist/modules/Queue/QueueContext.d.ts

@@ -1,8 +1,7 @@
 import { ReducerMiddlewareCallback } from '@plitzi/plitzi-ui/hooks/useReducerWithMiddleware';
 import { SchemaReducerActions } from '@plitzi/sdk-schema/SchemaReducer';
-import { Schema, Segment, Style } from '@plitzi/sdk-shared';
+import { Schema, Style } from '@plitzi/sdk-shared';
 import { StyleReducerActions } from '@plitzi/sdk-style/StyleReducer';
-import { SegmentsReducerActions } from '../Segments/SegmentsReducer';
 import { ActionDispatch } from 'react';
 export type QueueItem<TState = any, TDispatchAction = any> = {
     action: TDispatchAction;
@@ -11,9 +10,7 @@ export type QueueItem<TState = any, TDispatchAction = any> = {
     dispatch: ActionDispatch<[action: TDispatchAction]>;
 };
 export type QueueContextValue = {
-    enqueueMiddleware: ReducerMiddlewareCallback<Schema | Style | Record<string, Segment>, [
-        action: StyleReducerActions | SchemaReducerActions | SegmentsReducerActions
-    ]>;
+    enqueueMiddleware: ReducerMiddlewareCallback<Schema | Style, [action: StyleReducerActions | SchemaReducerActions]>;
 };
 declare const QueueContext: import('react').Context<QueueContextValue>;
 export default QueueContext;

package/dist/modules/Resources/components/Resource/subTypes/ResourceSnippet/ResourceSnippet.d.ts

@@ -0,0 +1,13 @@
+import { MouseEvent } from 'react';
+export type ResourceSnippetProps = {
+    className?: string;
+    id: string;
+    src: string;
+    title?: string;
+    removing?: boolean;
+    isLoading?: boolean;
+    onClick?: () => void;
+    onRemove?: (e: MouseEvent) => void;
+};
+declare const ResourceSnippet: ({ className, title, src, removing, isLoading, onClick, onRemove }: ResourceSnippetProps) => import('react').JSX.Element | undefined;
+export default ResourceSnippet;

package/dist/modules/Resources/components/Resource/subTypes/ResourceSnippet/SnippetContent.d.ts

@@ -0,0 +1,8 @@
+import { Snippet } from '@plitzi/sdk-shared';
+export type SnippetContentProps = {
+    baseElementId: string;
+    schema: Snippet['schema'];
+    style: Snippet['style'];
+};
+declare const SnippetContent: ({ baseElementId, schema, style }: SnippetContentProps) => import('react').JSX.Element;
+export default SnippetContent;

package/dist/modules/Resources/components/Resource/subTypes/ResourceSnippet/UnreadableSnippet.d.ts

@@ -0,0 +1,12 @@
+import { MouseEvent } from 'react';
+export type UnreadableSnippetProps = {
+    className?: string;
+    title?: string;
+    onRemove?: (e: MouseEvent) => void;
+};
+/**
+ * A file among the snippets that is not one — unreachable, or a JSON of some other shape. Shown rather than left out,
+ * so whoever put it there sees it and can take it away.
+ */
+declare const UnreadableSnippet: ({ className, title, onRemove }: UnreadableSnippetProps) => import('react').JSX.Element;
+export default UnreadableSnippet;

package/dist/modules/Resources/components/Resource/subTypes/ResourceSnippet/index.d.ts

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

package/dist/modules/Resources/components/ResourceManager/helpers/isSnippetFile.d.ts

@@ -0,0 +1,3 @@
+/** Whether a JSON being uploaded is a snippet — which decides it goes among the snippets rather than the files. */
+declare const isSnippetFile: (file: File) => Promise<boolean>;
+export default isSnippetFile;

package/dist/modules/Resources/components/ResourceManager/helpers/isSnippetFile.test.d.ts

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

package/dist/modules/Resources/components/ResourcesCdnBucket/ResourcesCdnBucket.d.ts

@@ -10,7 +10,7 @@ export type ResourcesCdnBucketProps = {
     onChange?: () => void;
 };
 /**
- * One bucket of a CDN and the space's files in it. A public one takes uploads — plugins, images, templates — and serves
+ * One bucket of a CDN and the space's files in it. A public one takes uploads — plugins, images, snippets — and serves
  * them at its domain; a private one keeps the space's server code, written when it is saved or pushed, and serves
  * nothing.
  */

package/dist/modules/Runtime/components/RuntimeCodeNote/RuntimeCodeNote.d.ts

@@ -4,9 +4,6 @@ export type RuntimeCodeNoteProps = {
     /** How long a runtime may go unused before it is stopped; 0 when the platform never stops one. */
     idleMinutes: number;
 };
-/**
- * Where a runtime's code comes from, said where the question comes up: nothing in the builder changes it. It is a
- * project of the space owner's own — Node, its packages — packed and pushed from there, and published with the space.
- */
+/** How a runtime gets here: it is written in a project of the author's and pushed, never edited in the builder. */
 declare const RuntimeCodeNote: ({ pushed, idleMinutes }: RuntimeCodeNoteProps) => import('react').JSX.Element;
 export default RuntimeCodeNote;

package/dist/modules/Space/components/SpaceIssues/SpaceIssues.d.ts

@@ -10,7 +10,8 @@ export type SpaceIssuesProps = {
 };
 /**
  * Everything the linter found in the saved space: errors first, since they are what stops a publish, then what renders
- * but most likely not as meant. Each one names its element and takes you to it.
+ * but most likely not as meant, then the shorter ways to the same page. Each one names its elements and takes you to
+ * them.
  */
 declare const SpaceIssues: ({ issues, intro, onDismiss, onFix }: SpaceIssuesProps) => import('react').JSX.Element;
 export default SpaceIssues;

package/dist/modules/Space/components/SpaceIssues/components/ElementChip/ElementChip.d.ts

@@ -0,0 +1,12 @@
+export type ElementChipProps = {
+    elementId: string;
+    /** Called once the element is on screen, so whatever holds the list can get out of the way. */
+    onDismiss: () => void;
+};
+/**
+ * An element named in the list, and the way to it: a link that opens its page or layout, unfolds the tree down to it
+ * and selects it. One deleted since the space was saved is named but not linked — there is nothing left to take anyone
+ * to, and what named it goes away with the next save.
+ */
+declare const ElementChip: ({ elementId, onDismiss }: ElementChipProps) => import('react').JSX.Element;
+export default ElementChip;

package/dist/modules/Space/components/SpaceIssues/components/ElementChip/index.d.ts

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

package/dist/modules/Space/components/SpaceIssues/components/IssueFix/IssueFix.d.ts

@@ -0,0 +1,12 @@
+export type IssueFixProps = {
+    /** What to write instead, as the code table has it: Markdown whose `code` is in backticks. */
+    fix: string;
+    /** What leads it — a problem's fix, or a suggestion's short way. */
+    label?: string;
+};
+/**
+ * What to write instead, under the problem it settles — the row the issue's code is filed under, so the panel says the
+ * fix the authoring page and an agent over MCP are told, not one of its own.
+ */
+declare const IssueFix: ({ fix, label }: IssueFixProps) => import('react').JSX.Element;
+export default IssueFix;

package/dist/modules/Space/components/SpaceIssues/components/IssueFix/index.d.ts

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

package/dist/modules/Space/components/SpaceIssues/components/IssueItem/IssueItem.d.ts

@@ -6,10 +6,6 @@ export type IssueItemProps = {
     /** Called once the element is on screen, so whatever holds the list can get out of the way. */
     onDismiss: () => void;
 };
-/**
- * One issue, and the way to it: the element it names is a link that opens its page or layout, unfolds the tree down
- * to it and selects it. An element deleted since the space was saved is named but not linked — there is nothing left
- * to take anyone to, and the issue goes away with the next save.
- */
+/** One issue, what to write instead, and the element it names — a link to it. */
 declare const IssueItem: ({ issue, severity, onDismiss }: IssueItemProps) => import('react').JSX.Element;
 export default IssueItem;

package/dist/modules/Space/components/SpaceIssues/components/SuggestionGroup/SuggestionGroup.d.ts

@@ -0,0 +1,8 @@
+import { TSpaceSuggestion } from '@plitzi/sdk-shared';
+export type SuggestionGroupProps = {
+    suggestions: TSpaceSuggestion[];
+    onDismiss: () => void;
+};
+/** The shorter ways to the same page, the ones that save the most elements first. Nothing in it blocks a publish. */
+declare const SuggestionGroup: ({ suggestions, onDismiss }: SuggestionGroupProps) => import('react').JSX.Element | null;
+export default SuggestionGroup;

package/dist/modules/Space/components/SpaceIssues/components/SuggestionGroup/index.d.ts

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

package/dist/modules/Space/components/SpaceIssues/components/SuggestionItem/SuggestionItem.d.ts

@@ -0,0 +1,12 @@
+import { TSpaceSuggestion } from '@plitzi/sdk-shared';
+export type SuggestionItemProps = {
+    suggestion: TSpaceSuggestion;
+    /** Called once an element is on screen, so whatever holds the list can get out of the way. */
+    onDismiss: () => void;
+};
+/**
+ * A shorter way to the same page: what it is, the short way, what taking it saves, and the elements it is about —
+ * the copies of a header, the buttons holding a text — each a link to it.
+ */
+declare const SuggestionItem: ({ suggestion, onDismiss }: SuggestionItemProps) => import('react').JSX.Element;
+export default SuggestionItem;

package/dist/modules/Space/components/SpaceIssues/components/SuggestionItem/index.d.ts

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

package/dist/modules/Space/components/SpaceIssues/helpers.d.ts

@@ -2,3 +2,5 @@ export type IssueSeverity = 'error' | 'warning';
 export declare const SEVERITY_TEXT: Record<IssueSeverity, string>;
 export declare const SEVERITY_ICON: Record<IssueSeverity, string>;
 export declare const MUTED = "text-zinc-500 dark:text-zinc-400";
+/** A suggestion is no problem at all: it reads in the accent, beside the red and the amber of what is wrong. */
+export declare const SUGGESTION_TEXT = "text-indigo-600 dark:text-indigo-400";

package/dist/modules/Space/hooks/useSpaceUsage.d.ts

@@ -0,0 +1,36 @@
+/** One page of the space and what it spent of the allowance this period. */
+export interface UsagePage {
+    path: string;
+    views: number;
+}
+/** Where this space's page views went this period, as `/spaces/:spaceId/usage` answers it. */
+export interface SpaceUsage {
+    planName: string;
+    periodEndsAt: string;
+    /** What this space spent; none where its plan sets no ceiling of its own. */
+    space: {
+        views: number;
+    } | null;
+    /** The heaviest pages, by page views. */
+    pages: UsagePage[];
+    /**
+     * What the page rows add up to, which is not the same as the space's views: an RSC refresh and a server action are
+     * charged to the space and answered at their own endpoints, so they belong to no page.
+     */
+    pagesTotal: number;
+}
+/**
+ * Where the allowance of the space being edited went, page by page — and only that space's: whoever edits a space is
+ * asking about that one, and may be a guest with no business reading the rest of its workspace.
+ *
+ * The ceilings themselves come over GraphQL (`SpaceQuota`) and are what the header meter is made of. This is the other
+ * half of the answer, asked for only while the panel showing it is mounted. It reads the API role, where the endpoint
+ * lives; the builder's user token rides in the header every other call uses. Fetched once per panel: these are period
+ * totals, not something that moves while somebody reads them.
+ */
+declare const useSpaceUsage: (spaceId: number) => {
+    usage: SpaceUsage | undefined;
+    error: string | undefined;
+    loading: boolean;
+};
+export default useSpaceUsage;

package/dist/modules/Undoable/UndoableContext.d.ts

@@ -1,9 +1,8 @@
 import { UndoableReducerActions } from './UndoableReducer';
 import { ReducerMiddlewareCallback } from '@plitzi/plitzi-ui/hooks/useReducerWithMiddleware';
 import { SchemaReducerActions } from '@plitzi/sdk-schema/SchemaReducer';
-import { Schema, Segment, Style } from '@plitzi/sdk-shared';
+import { Schema, Style } from '@plitzi/sdk-shared';
 import { StyleReducerActions } from '@plitzi/sdk-style/StyleReducer';
-import { SegmentsReducerActions } from '../Segments/SegmentsReducer';
 import { ActionDispatch } from 'react';
 export type UndoableItem<TState = any, TDispatchAction = any> = {
     action: TDispatchAction;
@@ -19,9 +18,7 @@ export type UndoableContextValue = {
     undoableUndo: () => void;
     undoableRedo: () => void;
     undoableClearHistory: () => void;
-    undoableMiddleware: ReducerMiddlewareCallback<Schema | Style | Record<string, Segment>, [
-        action: StyleReducerActions | SchemaReducerActions | SegmentsReducerActions
-    ]>;
+    undoableMiddleware: ReducerMiddlewareCallback<Schema | Style, [action: StyleReducerActions | SchemaReducerActions]>;
 };
 declare const UndoableContext: import('react').Context<UndoableContextValue>;
 export default UndoableContext;

package/dist/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@plitzi/plitzi-builder",
-  "version": "0.37.8",
+  "version": "0.37.10",
   "homepage": "./",
   "license": "AGPL-3.0",
   "files": [
@@ -30,10 +30,11 @@ declare const _default: {
     "@codemirror/autocomplete": "^6",
     "@codemirror/lint": "^6",
     "@codemirror/state": "^6",
+    "@codemirror/view": "^6",
     "@fortawesome/fontawesome-free": "^7.3.1",
-    "@plitzi/nexus": "^1.3.1",
+    "@plitzi/nexus": "^1.4.0",
     "@plitzi/plitzi-sdk": "workspace:*",
-    "@plitzi/plitzi-ui": "^1.6.24",
+    "@plitzi/plitzi-ui": "^1.6.29",
     "@plitzi/sdk-auth": "workspace:*",
     "@plitzi/sdk-authoring": "workspace:*",
     "@plitzi/sdk-dev-tools": "workspace:*",
@@ -49,7 +50,6 @@ declare const _default: {
     "@tanstack/react-virtual": "^3.14.13",
     "@typescript/vfs": "^1.6.5",
     "@valtown/codemirror-ts": "^2.3.1",
-    "@xyflow/react": "^12.11.6",
     "apollo-upload-client": "^20.0.0",
     "clsx": "^2.1.1",
     "comlink": "^4.4.2",