@plitzi/plitzi-builder 0.37.2 → 0.37.4

package/dist/modules/Resources/components/ResourceContent/components/ContentPlugin/index.d.ts

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

package/dist/modules/Resources/helpers.d.ts

@@ -0,0 +1,6 @@
+import { RootElements } from '@plitzi/sdk-schema/helpers/elementTree';
+import { ComponentDefinition, Schema } from '@plitzi/sdk-shared';
+/** The plugin a plugin resource installed: the main one of the bundle its manifest roots. */
+export declare const mainPluginOf: (plugins: Record<string, ComponentDefinition>, root: string) => ComponentDefinition | undefined;
+/** Where the space places a plugin's elements — its own and the ones it ships inside it — page by page. */
+export declare const pluginUsage: (flat: Schema["flat"], plugin: ComponentDefinition) => RootElements[];

package/dist/modules/Resources/helpers.test.d.ts

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

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

@@ -0,0 +1,8 @@
+/**
+ * The space's runtime: its own server code, run as a process of its own beside the platform — for what functions
+ * cannot be (Node and its packages, connections that stay open, an agent's endpoint). Its code is pushed from the
+ * project that holds it (`plitzi runtime push`), which the panel says in so many words; here is how each environment's
+ * is doing, and what it starts with.
+ */
+declare const Runtime: () => import('react').JSX.Element;
+export default Runtime;

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

@@ -0,0 +1,12 @@
+export type RuntimeCodeNoteProps = {
+    /** Whether the space has a runtime yet: without one, what a runtime is comes first. */
+    pushed: boolean;
+    /** 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.
+ */
+declare const RuntimeCodeNote: ({ pushed, idleMinutes }: RuntimeCodeNoteProps) => import('react').JSX.Element;
+export default RuntimeCodeNote;

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

@@ -0,0 +1,2 @@
+export { default } from './RuntimeCodeNote';
+export type { RuntimeCodeNoteProps } from './RuntimeCodeNote';

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

@@ -0,0 +1,13 @@
+import { SpaceRuntimeEnvironment, SpaceRuntimeSizeOption } from '@plitzi/sdk-shared';
+export type RuntimeEnvironmentsProps = {
+    environments: SpaceRuntimeEnvironment[];
+    /** Every size there is, and which the space's plan includes. */
+    sizes: SpaceRuntimeSizeOption[];
+    /** How long a runtime may go unused before it is stopped; 0 when the platform never stops one. */
+    idleMinutes: number;
+    /** Asked once something changed, to read the runtime again. */
+    onChange: () => Promise<void>;
+};
+/** Every environment's runtime: which code, how it is, and what it serves — and taking the runtime away. */
+declare const RuntimeEnvironments: ({ environments, sizes, idleMinutes, onChange }: RuntimeEnvironmentsProps) => import('react').JSX.Element;
+export default RuntimeEnvironments;

package/dist/modules/Runtime/components/RuntimeEnvironments/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './RuntimeEnvironments';
+export type { RuntimeEnvironmentsProps } from './RuntimeEnvironments';

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

@@ -0,0 +1,15 @@
+import { SpaceRuntimeEnvironment } from '@plitzi/sdk-shared';
+export type RuntimePowerProps = {
+    runtime: SpaceRuntimeEnvironment;
+    /** How long a runtime may go unused before it is stopped; 0 when the platform never stops one. */
+    idleMinutes: number;
+    /** Asked once it was started or stopped, to read the runtime again. */
+    onChange: () => Promise<void>;
+};
+/**
+ * Starting and stopping an environment's runtime — the buttons held while a request is on its way and while the runtime
+ * is starting or stopping, which its status says — and saying when it stops by itself: a runtime nobody uses for a while
+ * is stopped so it spends nothing, and stays stopped until somebody starts it again, here or with a push or a publish.
+ */
+declare const RuntimePower: ({ runtime, idleMinutes, onChange }: RuntimePowerProps) => import('react').JSX.Element;
+export default RuntimePower;

package/dist/modules/Runtime/components/RuntimePower/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './RuntimePower';
+export type { RuntimePowerProps } from './RuntimePower';

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

@@ -0,0 +1,17 @@
+import { SpaceRuntimeEnvironment, SpaceRuntimeSizeOption } from '@plitzi/sdk-shared';
+export type RuntimeSizeProps = {
+    environment: string;
+    /** The size it runs at, by name. */
+    size: string;
+    status: SpaceRuntimeEnvironment['status'];
+    sizes: SpaceRuntimeSizeOption[];
+    /** Asked once the size changed, to read the runtime again. */
+    onChange: () => Promise<void>;
+};
+/**
+ * The size an environment's runtime runs at, and choosing another among those the space's plan includes. Nothing
+ * changes until it is applied — a restart is not something a slip of the select should cause — and while the runtime
+ * restarts at the new size, it says so.
+ */
+declare const RuntimeSize: ({ environment, size, status, sizes, onChange }: RuntimeSizeProps) => import('react').JSX.Element;
+export default RuntimeSize;

package/dist/modules/Runtime/components/RuntimeSize/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './RuntimeSize';
+export type { RuntimeSizeProps } from './RuntimeSize';

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

@@ -0,0 +1,11 @@
+export type RuntimeVariablesProps = {
+    /** The variables it has, by name. */
+    names: string[];
+    onChange: () => Promise<void>;
+};
+/**
+ * What the runtime starts with — a connection string, a key. Written here and never read back: a value is kept
+ * encrypted and handed to the runtime alone. Changing one starts the runtime again with it.
+ */
+declare const RuntimeVariables: ({ names, onChange }: RuntimeVariablesProps) => import('react').JSX.Element;
+export default RuntimeVariables;

package/dist/modules/Runtime/components/RuntimeVariables/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './RuntimeVariables';
+export type { RuntimeVariablesProps } from './RuntimeVariables';

package/dist/modules/Runtime/helpers/idleDurationOf.d.ts

@@ -0,0 +1,6 @@
+/**
+ * How long a runtime may go unused, in the largest unit it is a whole number of: a week reads `7 days`, not `10080
+ * minutes`.
+ */
+declare const idleDurationOf: (minutes: number) => string;
+export default idleDurationOf;

package/dist/modules/Runtime/helpers/idleDurationOf.test.d.ts

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

package/dist/modules/Runtime/helpers/stopMomentOf.d.ts

@@ -0,0 +1,6 @@
+/**
+ * When a runtime stops by itself, in the viewer's own time: with its day, since an idle time counted in days puts it
+ * well past today.
+ */
+declare const stopMomentOf: (seconds: number) => string;
+export default stopMomentOf;

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

@@ -0,0 +1 @@
+export { default } from './Runtime';

package/dist/modules/Schema/helpers/templateProblem.d.ts

@@ -0,0 +1,8 @@
+/**
+ * What is wrong with a template as it is being typed, in the words the linter uses on the saved space — or nothing.
+ *
+ * The runtime skips what it cannot read and renders a value nobody wrote, so the editor says so while the text is
+ * still in front of whoever wrote it, rather than after a save puts it in the problems list. Only the syntax: which
+ * names are in scope depends on where the template lands, and that is the saved-space check's to answer.
+ */
+export declare const templateProblem: (value: unknown) => string | undefined;

package/dist/modules/Schema/helpers/templateProblem.test.d.ts

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

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

@@ -0,0 +1,16 @@
+import { TSpaceIssues } from '@plitzi/sdk-shared';
+export type SpaceIssuesProps = {
+    issues: TSpaceIssues;
+    /** Said above the list — why it is being shown, when that is not simply because someone asked. */
+    intro?: string;
+    /** Called once the list has served its purpose — someone went to an element, or had the fixable ones fixed. */
+    onDismiss: () => void;
+    /** Fixes what has one reading; offered only when something in the list has. */
+    onFix?: () => Promise<unknown>;
+};
+/**
+ * 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.
+ */
+declare const SpaceIssues: ({ issues, intro, onDismiss, onFix }: SpaceIssuesProps) => import('react').JSX.Element;
+export default SpaceIssues;

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

@@ -0,0 +1,10 @@
+import { IssueSeverity } from '../../helpers';
+import { TSpaceIssue } from '@plitzi/sdk-shared';
+export type IssueGroupProps = {
+    title: string;
+    issues: TSpaceIssue[];
+    severity: IssueSeverity;
+    onDismiss: () => void;
+};
+declare const IssueGroup: ({ title, issues, severity, onDismiss }: IssueGroupProps) => import('react').JSX.Element | null;
+export default IssueGroup;

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

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

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

@@ -0,0 +1,15 @@
+import { IssueSeverity } from '../../helpers';
+import { TSpaceIssue } from '@plitzi/sdk-shared';
+export type IssueItemProps = {
+    issue: TSpaceIssue;
+    severity: IssueSeverity;
+    /** 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.
+ */
+declare const IssueItem: ({ issue, severity, onDismiss }: IssueItemProps) => import('react').JSX.Element;
+export default IssueItem;

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

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

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

@@ -0,0 +1,4 @@
+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";

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

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

package/dist/modules/Space/helpers/spaceIssues.d.ts

@@ -0,0 +1,15 @@
+import { TSpaceIssue, TSpaceIssues } from '@plitzi/sdk-shared';
+/** What the server answers a publish of a space that would ship broken with, carrying the issues it found. */
+export declare const SPACE_INVALID = "SPACE_INVALID";
+/** Said above the list when it is shown instead of the publish someone asked for. */
+export declare const PUBLISH_REFUSED = "This space cannot be published yet: what is listed under Errors would ship broken. Fix it, and publish again.";
+export type IssuesLevel = 'clean' | 'warnings' | 'errors';
+/**
+ * The issues a refused publish came back with, or undefined when it was refused for anything else — a plan ceiling, a
+ * network failure — which is told the way it always was.
+ */
+export declare const issuesFromError: (error: unknown) => TSpaceIssue[] | undefined;
+/** How many of the issues `SpaceFixIssues` settles on its own — the ones with a single reading. */
+export declare const fixableCount: (issues: TSpaceIssues) => number;
+/** The worst thing in the list: errors stop a publish, warnings only ask to be looked at. */
+export declare const levelOf: (issues: TSpaceIssues) => IssuesLevel;

package/dist/modules/Space/helpers/spaceIssues.test.d.ts

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

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

@@ -0,0 +1,9 @@
+/**
+ * Asks the server to fix every issue of the saved space that has one reading, and puts the result on screen.
+ *
+ * The fix is made where the document lives, so it is held to the same integrity as every save and reaches the other
+ * editors as a schema update. Here the returned schema is applied as a change that already happened on the server —
+ * from subscriptions — so the save queue does not send it straight back. Resolves with the changes made.
+ */
+declare const useFixSpaceIssues: () => () => Promise<import('@plitzi/sdk-shared/network/graphql/builder/Mutations/Space/SpaceFixIssuesMutation').TSpaceFix[]>;
+export default useFixSpaceIssues;

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

@@ -0,0 +1,8 @@
+import { TSpaceIssues } from '@plitzi/sdk-shared';
+/**
+ * Opens the list of what is wrong with the space. The same list whether someone asked for it or a publish was refused
+ * over it — only the line above it changes — and following an element out of it closes it, so the element is what is
+ * left on screen.
+ */
+declare const useShowSpaceIssues: () => (issues: TSpaceIssues, intro?: string) => Promise<unknown>;
+export default useShowSpaceIssues;

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

@@ -0,0 +1,14 @@
+import { TSpaceIssues } from '@plitzi/sdk-shared';
+/**
+ * What is wrong with the space as it is SAVED, read by the same linter the publish gate runs.
+ *
+ * Asked again each time the save queue drains, not on every edit: the server can only read what it holds, and the
+ * builder's own schema is ahead of it for as long as anything is still queued. `refresh` answers with the fresh list,
+ * for a caller that has to decide on it — publishing — rather than just show it.
+ */
+declare const useSpaceIssues: () => {
+    issues: TSpaceIssues | undefined;
+    error: Error | undefined;
+    refresh: () => Promise<TSpaceIssues | undefined>;
+};
+export default useSpaceIssues;

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

@@ -11,7 +11,6 @@ export type UndoableItem<TState = any, TDispatchAction = any> = {
     nextState: TState;
     prevState: TState;
 };
-export type UndoableDispatch = ActionDispatch<[action: UndoableReducerActions]>;
 export type UndoableContextValue = {
     canUndo: boolean;
     canRedo: boolean;

package/dist/modules/Visitors/Visitors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Who may do what here, as a visitor: the space's roles, and the people given them.
+ *
+ * The roles are the space's own — declared in its settings, published and exported with it. Who holds them is not:
+ * it is a list of people, kept by the platform, never in a document anybody can read.
+ */
+declare const Visitors: () => import('react').JSX.Element;
+export default Visitors;

package/dist/modules/Visitors/components/VisitorGrants/VisitorGrants.d.ts

@@ -0,0 +1,12 @@
+export type VisitorGrantsProps = {
+    /** The roles the space declares, which are the only ones that can be given. */
+    roles: string[];
+};
+/**
+ * Who holds which of the space's visitor roles, given by email.
+ *
+ * Nobody needs an account yet: a role given to an address waits until somebody signs in with it — verified — and is
+ * theirs from then on. Taking one back is immediate.
+ */
+declare const VisitorGrants: ({ roles }: VisitorGrantsProps) => import('react').JSX.Element;
+export default VisitorGrants;

package/dist/modules/Visitors/components/VisitorGrants/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './VisitorGrants';
+export type { VisitorGrantsProps } from './VisitorGrants';

package/dist/modules/Visitors/components/VisitorRoles/VisitorRoles.d.ts

@@ -0,0 +1,13 @@
+import { VisitorRoles as TVisitorRoles } from '@plitzi/sdk-shared/auth/visitorRoles';
+export type VisitorRolesProps = {
+    /** The roles the space declares (`settings.visitorRoles`), as the builder's document holds them. */
+    roles: TVisitorRoles;
+};
+/**
+ * The space's visitor roles and what each gives — the permissions an action's `access: 'role'` names.
+ *
+ * Saved as they are typed, and only when they are valid: a role the server would refuse is shown with what is wrong
+ * instead of being sent, so the document never holds a half-written role that grants something by accident.
+ */
+declare const VisitorRoles: ({ roles }: VisitorRolesProps) => import('react').JSX.Element;
+export default VisitorRoles;

package/dist/modules/Visitors/components/VisitorRoles/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './VisitorRoles';
+export type { VisitorRolesProps } from './VisitorRoles';

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

@@ -0,0 +1 @@
+export { default } from './Visitors';

package/dist/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@plitzi/plitzi-builder",
-  "version": "0.37.2",
+  "version": "0.37.4",
   "homepage": "./",
   "license": "AGPL-3.0",
   "files": [
@@ -27,10 +27,13 @@ declare const _default: {
   },
   "dependencies": {
     "@apollo/client": "^4.3.1",
+    "@codemirror/autocomplete": "^6",
+    "@codemirror/lint": "^6",
+    "@codemirror/state": "^6",
     "@fortawesome/fontawesome-free": "^7.3.1",
-    "@plitzi/nexus": "^1.2.2",
+    "@plitzi/nexus": "^1.3.1",
     "@plitzi/plitzi-sdk": "workspace:*",
-    "@plitzi/plitzi-ui": "^1.6.22",
+    "@plitzi/plitzi-ui": "^1.6.24",
     "@plitzi/sdk-auth": "workspace:*",
     "@plitzi/sdk-authoring": "workspace:*",
     "@plitzi/sdk-dev-tools": "workspace:*",
@@ -44,9 +47,12 @@ declare const _default: {
     "@plitzi/sdk-style": "workspace:*",
     "@plitzi/sdk-variables": "workspace:*",
     "@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",
     "graphql": "^17.0.2",
     "graphql-ws": "^6.2.2",
     "immer": "^11.1.18",
@@ -72,6 +78,7 @@ declare const _default: {
     "@babel/polyfill": "^7.12.1",
     "@babel/preset-env": "^8.0.6",
     "@babel/preset-react": "^8.0.1",
+    "@plitzi/sdk-server": "workspace:*",
     "@tailwindcss/postcss": "^4.3.3",
     "css-loader": "^7.1.5",
     "eslint": "^9.39.5",
@@ -94,7 +101,7 @@ declare const _default: {
     "stylelint-scss": "^7.3.0",
     "terser": "^5.51.2",
     "typescript": "^6.0.3",
-    "vite": "^8.3.0",
+    "vite": "^8.3.1",
     "vite-plugin-dts": "^5.1.1",
     "vite-plugin-ejs": "^2.0.0",
     "vite-plugin-mkcert": "^2.1.0",
@@ -109,11 +116,11 @@ declare const _default: {
     "lint-style": "stylelint \"**/*.scss\" --custom-syntax postcss-scss",
     "lint-style:fix": "stylelint \"**/*.scss\" --custom-syntax postcss-scss --fix",
     "typecheck": "tsc -p tsconfig.app.json --noEmit",
-    "build:dev": "tsc -p tsconfig.app.json --noEmit && vite build --mode development",
+    "build:dev": "tsc -p tsconfig.app.json --noEmit && vite build --mode development && vite build --config vite.functions-worker.config.ts --mode development",
     "build:dev-watch": "tsc -p tsconfig.app.json --noEmit && vite build --mode development --watch",
     "build:dev-gzip": "tsc -p tsconfig.app.json --noEmit && ONLY_GZIP=1 vite build --mode development",
     "build:dev-analyze": "tsc -p tsconfig.app.json --noEmit && ONLY_ANALYZE=1 vite build --mode development",
-    "build:prod": "tsc -p tsconfig.app.json --noEmit && vite build",
+    "build:prod": "tsc -p tsconfig.app.json --noEmit && vite build && vite build --config vite.functions-worker.config.ts",
     "build:prod-watch": "tsc -p tsconfig.app.json --noEmit && vite build --watch",
     "build:prod-gzip": "tsc -p tsconfig.app.json --noEmit && ONLY_GZIP=1 vite build",
     "build:prod-analyze": "tsc -p tsconfig.app.json --noEmit && ONLY_ANALYZE=1 vite build",