@phis/ui 0.1.0

package/plugins/runtime/slot-size-policy.js

@@ -0,0 +1,176 @@
+import { isValidElement } from "react";
+const PHI_SLOT_CHILD_DEFAULT_POLICY = {
+    widget: {
+        inline: "intrinsic",
+        block: "intrinsic",
+    },
+    layout: {
+        inline: "fill",
+        block: "fill",
+    },
+};
+function normalizePhiSlotPolicyAxis(axis, fallback) {
+    return axis === "fill" || axis === "fixed" || axis === "intrinsic" ? axis : fallback;
+}
+export function resolvePhiSlotSizePolicy(policy, kind) {
+    const fallback = PHI_SLOT_CHILD_DEFAULT_POLICY[kind];
+    if (policy == null || policy === "intrinsic") {
+        return fallback;
+    }
+    if (policy === "fill") {
+        return {
+            inline: "fill",
+            block: "fill",
+        };
+    }
+    if (policy === "fill-inline") {
+        return {
+            inline: "fill",
+            block: "intrinsic",
+        };
+    }
+    if (policy === "fill-block") {
+        return {
+            inline: "intrinsic",
+            block: "fill",
+        };
+    }
+    if (policy === "fixed") {
+        return {
+            inline: "fixed",
+            block: "fixed",
+        };
+    }
+    return {
+        inline: normalizePhiSlotPolicyAxis(policy.inline, fallback.inline),
+        block: normalizePhiSlotPolicyAxis(policy.block, fallback.block),
+    };
+}
+export function resolvePhiSlotChildExplicitAxes(config) {
+    return {
+        explicitInlineSize: config?.size?.width != null,
+        explicitBlockSize: config?.size?.height != null,
+    };
+}
+function resolvePhiSlotChildSizeConstraints(config) {
+    return {
+        minInlineSize: config?.minSize?.width ?? undefined,
+        minBlockSize: config?.minSize?.height ?? undefined,
+        maxInlineSize: config?.maxSize?.width ?? undefined,
+        maxBlockSize: config?.maxSize?.height ?? undefined,
+    };
+}
+/**
+ * The sizing a client-enhanced slot child hands to the parent layout, resolved rather than referred.
+ *
+ * A Widget that needs a client frame is rendered through the Render Client Host, and the parent layout
+ * still has to learn how it sizes. Passing the block config along for the parent to read looked like the
+ * small move, and it put the same object in two places of one element's props. React's serializer writes
+ * the second one as a reference back into the element it is still building, to be filled in once that
+ * element exists -- and element props are frozen on creation in development, so the write can throw
+ * `Cannot assign to read only property 'config'` and take the Widget's whole render with it. The account
+ * menu was lost to exactly that shape, from a different source; see the Account Widget plugin.
+ *
+ * Six resolved values carry the same information and share nothing, so there is no reference to fill in.
+ */
+export function resolvePhiSlotChildSizingForConfig(kind, slotSizePolicy, config) {
+    return {
+        policy: resolvePhiSlotSizePolicy(slotSizePolicy, kind),
+        ...resolvePhiSlotChildExplicitAxes(config),
+        ...resolvePhiSlotChildSizeConstraints(config),
+    };
+}
+export function buildPhiSlotChildClassName(policy) {
+    return [
+        "phi-slot-child",
+        `phi-slot-child--inline-${policy.inline}`,
+        `phi-slot-child--block-${policy.block}`,
+    ].join(" ");
+}
+export function buildPhiSlotChildDataAttributes(policy, options) {
+    const explicitInlineSize = options?.explicitInlineSize === true;
+    const explicitBlockSize = options?.explicitBlockSize === true;
+    const fillInline = policy.inline === "fill";
+    const fillBlock = policy.block === "fill";
+    const serializeSize = (value) => typeof value === "number" ? `${value}px` : value;
+    return {
+        "data-phi-slot-size-inline": policy.inline,
+        "data-phi-slot-size-block": policy.block,
+        "data-phi-layout-fill-slot": fillInline || fillBlock ? "true" : undefined,
+        "data-phi-layout-explicit-width": explicitInlineSize ? "true" : undefined,
+        "data-phi-layout-explicit-height": explicitBlockSize ? "true" : undefined,
+        "data-phi-slot-min-inline-size": serializeSize(options?.minInlineSize),
+        "data-phi-slot-min-block-size": serializeSize(options?.minBlockSize),
+        "data-phi-slot-max-inline-size": serializeSize(options?.maxInlineSize),
+        "data-phi-slot-max-block-size": serializeSize(options?.maxBlockSize),
+    };
+}
+export function resolvePhiSlotChildSizing(child, fallbackKind = "widget") {
+    if (!isValidElement(child)) {
+        return {
+            policy: resolvePhiSlotSizePolicy(undefined, fallbackKind),
+            explicitInlineSize: false,
+            explicitBlockSize: false,
+        };
+    }
+    const props = child.props;
+    const sizingProps = props.slotChildSizing;
+    if (sizingProps?.policy) {
+        return sizingProps;
+    }
+    const configConstraints = resolvePhiSlotChildSizeConstraints(props.config);
+    if (props.slotSizePolicy != null || props.kind != null) {
+        const resolvedKind = props.kind === "widget" || props.kind === "layout"
+            ? props.kind
+            : fallbackKind;
+        return {
+            policy: resolvePhiSlotSizePolicy(props.slotSizePolicy, resolvedKind),
+            explicitInlineSize: props.explicitInlineSize === true || props["data-phi-layout-explicit-width"] === "true",
+            explicitBlockSize: props.explicitBlockSize === true || props["data-phi-layout-explicit-height"] === "true",
+            ...configConstraints,
+        };
+    }
+    const policy = resolvePhiSlotSizePolicy({
+        inline: props["data-phi-slot-size-inline"] === "fill" ||
+            props["data-phi-slot-size-inline"] === "fixed" ||
+            props["data-phi-slot-size-inline"] === "intrinsic"
+            ? props["data-phi-slot-size-inline"]
+            : undefined,
+        block: props["data-phi-slot-size-block"] === "fill" ||
+            props["data-phi-slot-size-block"] === "fixed" ||
+            props["data-phi-slot-size-block"] === "intrinsic"
+            ? props["data-phi-slot-size-block"]
+            : undefined,
+    }, fallbackKind);
+    return {
+        policy,
+        explicitInlineSize: props["data-phi-layout-explicit-width"] === "true",
+        explicitBlockSize: props["data-phi-layout-explicit-height"] === "true",
+        minInlineSize: configConstraints.minInlineSize ??
+            (typeof props["data-phi-slot-min-inline-size"] === "string"
+                ? props["data-phi-slot-min-inline-size"]
+                : undefined),
+        minBlockSize: configConstraints.minBlockSize ??
+            (typeof props["data-phi-slot-min-block-size"] === "string"
+                ? props["data-phi-slot-min-block-size"]
+                : undefined),
+        maxInlineSize: configConstraints.maxInlineSize ??
+            (typeof props["data-phi-slot-max-inline-size"] === "string"
+                ? props["data-phi-slot-max-inline-size"]
+                : undefined),
+        maxBlockSize: configConstraints.maxBlockSize ??
+            (typeof props["data-phi-slot-max-block-size"] === "string"
+                ? props["data-phi-slot-max-block-size"]
+                : undefined),
+    };
+}
+export function resolvePhiSlotChildBaseStyle(policy) {
+    return {
+        minWidth: 0,
+        minHeight: 0,
+        maxWidth: "100%",
+        maxHeight: "100%",
+        ...(policy.inline === "fill" ? { width: "100%" } : policy.inline === "intrinsic" ? { width: "fit-content" } : {}),
+        ...(policy.block === "fill" ? { height: "100%" } : policy.block === "intrinsic" ? { height: "fit-content" } : {}),
+    };
+}

package/plugins/runtime-modules/accounting/authoring.d.ts

@@ -0,0 +1 @@
+export declare const PhiAccountingRuntimeModuleAuthoringClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleAuthoringClientProps>;

package/plugins/runtime-modules/accounting/authoring.js

@@ -0,0 +1,4 @@
+"use client";
+import { PHI_ACCOUNTING_RUNTIME_MODULE_ID } from "./ids";
+import { createPhiAreaBaseRuntimeModuleAuthoringClient } from "../area-base-authoring";
+export const PhiAccountingRuntimeModuleAuthoringClient = createPhiAreaBaseRuntimeModuleAuthoringClient(PHI_ACCOUNTING_RUNTIME_MODULE_ID);

package/plugins/runtime-modules/accounting/client.d.ts

@@ -0,0 +1 @@
+export declare const PhiLazyAccountingRuntimeControllerClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleControllerClientProps>;

package/plugins/runtime-modules/accounting/client.js

@@ -0,0 +1,7 @@
+"use client";
+import dynamic from "next/dynamic";
+/*
+ * next/dynamic rather than a loader: rendered during the server render, it names its chunks in the
+ * route's loadable manifest, and the HTML asks for them before hydration instead of after it.
+ */
+export const PhiLazyAccountingRuntimeControllerClient = dynamic(() => import("../../../components/runtime/accounting-base-controller-plugin").then((module) => module.PhiAccountingBaseControllerClient));

package/plugins/runtime-modules/accounting/definition.d.ts

@@ -0,0 +1,15 @@
+export declare const PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION: Omit<{
+    area: "accounting";
+    moduleId: "@phis/ui/modules/accounting";
+    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
+    controllerType: "@phis/ui/modules/accounting/controller/base";
+    controller: import("../contracts").PhiRuntimeModuleControllerDescriptor;
+    description: string;
+    category: "foundation";
+    icon: string;
+    controllerMountPolicy: "area";
+}, "area"> & {
+    kind: "module";
+    eligibleAreas: readonly ["public" | "app" | "admin" | "builder" | "editor" | "accounting"];
+    title: "Public Base" | "App Base" | "Accounting Base" | "Admin Base" | "Builder Base" | "Editor Base";
+};

package/plugins/runtime-modules/accounting/definition.js

@@ -0,0 +1,17 @@
+import { PHI_ACCOUNTING_BASE_CONTROLLER_DEFINITION, } from "../../../components/runtime/area-base-controller-definitions";
+import { PHI_ACCOUNTING_BASE_CONTROLLER_TYPE, } from "../../../components/runtime/area-base-controller-addresses";
+import { buildPhiRuntimeModuleControllerDescriptor } from "../contracts";
+import { definePhiAreaBaseRuntimeModuleDefinition } from "../area-base-definition";
+import { PHI_ACCOUNTING_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_CORE_SERVER_BINDING, } from "../../../types/server-capabilities";
+export const PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION = definePhiAreaBaseRuntimeModuleDefinition({
+    area: "accounting",
+    moduleId: PHI_ACCOUNTING_RUNTIME_MODULE_ID,
+    serverBinding: PHI_CORE_SERVER_BINDING,
+    controllerType: PHI_ACCOUNTING_BASE_CONTROLLER_TYPE,
+    controller: buildPhiRuntimeModuleControllerDescriptor(PHI_ACCOUNTING_BASE_CONTROLLER_DEFINITION),
+    description: "Locked Accounting Area shell, navigation surface, and accounting workspace route.",
+    category: "foundation",
+    icon: "antd:profile",
+    controllerMountPolicy: "area",
+});

package/plugins/runtime-modules/accounting/ids.d.ts

@@ -0,0 +1 @@
+export declare const PHI_ACCOUNTING_RUNTIME_MODULE_ID: "@phis/ui/modules/accounting";

package/plugins/runtime-modules/accounting/ids.js

@@ -0,0 +1,2 @@
+import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
+export const PHI_ACCOUNTING_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/accounting`;

package/plugins/runtime-modules/accounting/module.d.ts

@@ -0,0 +1 @@
+export declare const PHI_ACCOUNTING_RUNTIME_MODULE: import("../contracts").PhiRuntimeModule;

package/plugins/runtime-modules/accounting/module.js

@@ -0,0 +1,4 @@
+import { PHI_ACCOUNTING_BASE_CONTROLLER_DEFINITION } from "../../../components/runtime/area-base-controller-definitions";
+import { PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION } from "../accounting/definition";
+import { createPhiAreaBaseRuntimeModule } from "../area-base-module";
+export const PHI_ACCOUNTING_RUNTIME_MODULE = createPhiAreaBaseRuntimeModule(PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION, PHI_ACCOUNTING_BASE_CONTROLLER_DEFINITION);

package/plugins/runtime-modules/accounting/server.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The unselectable base module of its Area. Shells and routes come from the shared Area-base preset
+ * list and are filtered by owner, so each base module states its own half of it.
+ */
+export declare const PHI_ACCOUNTING_RUNTIME_MODULE_SERVER_AREA_CONTRIBUTION: import("../area-contributions").PhiRuntimeModuleServerAreaContribution;

package/plugins/runtime-modules/accounting/server.js

@@ -0,0 +1,18 @@
+import { PHI_AREA_BASE_RUNTIME_MODULE_AREA_SHELLS, PHI_AREA_BASE_RUNTIME_MODULE_ROUTES, } from "../area-base-presets";
+import { definePhiRuntimeModuleServerAreaContribution } from "../area-contributions";
+import { PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION } from "../accounting/definition";
+/**
+ * The unselectable base module of its Area. Shells and routes come from the shared Area-base preset
+ * list and are filtered by owner, so each base module states its own half of it.
+ */
+export const PHI_ACCOUNTING_RUNTIME_MODULE_SERVER_AREA_CONTRIBUTION = definePhiRuntimeModuleServerAreaContribution({
+    moduleId: PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION.moduleId,
+    catalogEntry: {
+        definition: PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION,
+        widgets: [],
+        layouts: [],
+        areaShells: PHI_AREA_BASE_RUNTIME_MODULE_AREA_SHELLS.filter((descriptor) => descriptor.ownerModuleId === PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION.moduleId),
+        routes: PHI_AREA_BASE_RUNTIME_MODULE_ROUTES.filter((descriptor) => descriptor.ownerModuleId === PHI_ACCOUNTING_RUNTIME_MODULE_DEFINITION.moduleId),
+        load: () => import("./module").then((module) => module.PHI_ACCOUNTING_RUNTIME_MODULE),
+    },
+});

package/plugins/runtime-modules/admin/authoring-widgets.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("react").ComponentType<import("../client-authoring-widget-module").PhiAuthoringWidgetModuleProps>;
+export default _default;

package/plugins/runtime-modules/admin/authoring-widgets.js

@@ -0,0 +1,3 @@
+"use client";
+import { createPhiAuthoringWidgetModule } from "../client-authoring-widget-module";
+export default createPhiAuthoringWidgetModule([]);

package/plugins/runtime-modules/admin/authoring.d.ts

@@ -0,0 +1 @@
+export declare const PhiAdminRuntimeModuleAuthoringClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleAuthoringClientProps>;

package/plugins/runtime-modules/admin/authoring.js

@@ -0,0 +1,8 @@
+"use client";
+import WidgetModule from "./authoring-widgets";
+import { createPhiRuntimeModuleAuthoringClient } from "../client-authoring-module";
+import { PHI_ADMIN_RUNTIME_MODULE_ID } from "./ids";
+export const PhiAdminRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
+    moduleId: PHI_ADMIN_RUNTIME_MODULE_ID,
+    WidgetModule,
+});

package/plugins/runtime-modules/admin/client.d.ts

@@ -0,0 +1 @@
+export declare const PhiLazyAdminRuntimeControllerClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleControllerClientProps>;

package/plugins/runtime-modules/admin/client.js

@@ -0,0 +1,7 @@
+"use client";
+import dynamic from "next/dynamic";
+/*
+ * next/dynamic rather than a loader: rendered during the server render, it names its chunks in the
+ * route's loadable manifest, and the HTML asks for them before hydration instead of after it.
+ */
+export const PhiLazyAdminRuntimeControllerClient = dynamic(() => import("../../../plugins/runtime-modules/admin/controller/client").then((module) => module.PhiAdminRuntimeControllerClient));

package/plugins/runtime-modules/admin/controller/address.d.ts

@@ -0,0 +1,5 @@
+export declare const PHI_ADMIN_CONTROLLER_PLUGIN_KEY = "@phis/ui/modules/admin/controller";
+export declare const PHI_ADMIN_CONTROLLER_KEY = "default";
+export declare const PHI_ADMIN_CONTROLLER_TYPE: "@phis/ui/modules/admin/controller/default";
+export declare const PHI_ADMIN_CONTROLLER_INSTANCE_KEY = "default";
+export declare function createPhiAdminControllerAddress(): `controller:${string}/${string}:${string}`;

package/plugins/runtime-modules/admin/controller/address.js

@@ -0,0 +1,8 @@
+import { PHI_SHARED_PACKAGE_NAME, createPhiControllerSignalAddress } from "../../../../types/signals";
+export const PHI_ADMIN_CONTROLLER_PLUGIN_KEY = `${PHI_SHARED_PACKAGE_NAME}/modules/admin/controller`;
+export const PHI_ADMIN_CONTROLLER_KEY = "default";
+export const PHI_ADMIN_CONTROLLER_TYPE = `${PHI_ADMIN_CONTROLLER_PLUGIN_KEY}/${PHI_ADMIN_CONTROLLER_KEY}`;
+export const PHI_ADMIN_CONTROLLER_INSTANCE_KEY = "default";
+export function createPhiAdminControllerAddress() {
+    return createPhiControllerSignalAddress(PHI_ADMIN_CONTROLLER_PLUGIN_KEY, PHI_ADMIN_CONTROLLER_KEY, PHI_ADMIN_CONTROLLER_INSTANCE_KEY);
+}

package/plugins/runtime-modules/admin/controller/client.d.ts

@@ -0,0 +1,18 @@
+import { type PhiAdminControllerConfig } from "../controller/definition";
+export declare const PHI_ADMIN_RUNTIME_CONTROLLER_PLUGIN: {
+    renderController: () => null;
+    kind: "controller";
+    pluginKey: string;
+    key: string;
+    title: string;
+    description: string;
+    iconFamily: string;
+    allowedMountScopes: "area"[];
+    runtimeSignals: {
+        emits: never[];
+        listens: never[];
+    };
+    defaultConfig: {};
+    parseConfig: () => PhiAdminControllerConfig;
+};
+export declare const PhiAdminRuntimeControllerClient: (props: import("../../contracts").PhiRuntimeModuleControllerClientProps) => import("react").JSX.Element;

package/plugins/runtime-modules/admin/controller/client.js

@@ -0,0 +1,8 @@
+"use client";
+import { createPhiRuntimeControllerClient } from "../../../../components/runtime/runtime-controller-client-factory";
+import { PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION, } from "../controller/definition";
+export const PHI_ADMIN_RUNTIME_CONTROLLER_PLUGIN = {
+    ...PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION,
+    renderController: () => null,
+};
+export const PhiAdminRuntimeControllerClient = createPhiRuntimeControllerClient(PHI_ADMIN_RUNTIME_CONTROLLER_PLUGIN);

package/plugins/runtime-modules/admin/controller/definition.d.ts

@@ -0,0 +1,16 @@
+export type PhiAdminControllerConfig = Record<string, never>;
+export declare const PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION: {
+    kind: "controller";
+    pluginKey: string;
+    key: string;
+    title: string;
+    description: string;
+    iconFamily: string;
+    allowedMountScopes: "area"[];
+    runtimeSignals: {
+        emits: never[];
+        listens: never[];
+    };
+    defaultConfig: {};
+    parseConfig: () => PhiAdminControllerConfig;
+};

package/plugins/runtime-modules/admin/controller/definition.js

@@ -0,0 +1,13 @@
+import { PHI_ADMIN_CONTROLLER_KEY, PHI_ADMIN_CONTROLLER_PLUGIN_KEY } from "../controller/address";
+export const PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION = {
+    kind: "controller",
+    pluginKey: PHI_ADMIN_CONTROLLER_PLUGIN_KEY,
+    key: PHI_ADMIN_CONTROLLER_KEY,
+    title: "Admin Controller",
+    description: "Area-base owner for the Admin shell, navigation surface, and Admin settings.",
+    iconFamily: "admin",
+    allowedMountScopes: ["area"],
+    runtimeSignals: { emits: [], listens: [] },
+    defaultConfig: {},
+    parseConfig: () => ({}),
+};

package/plugins/runtime-modules/admin/definition.d.ts

@@ -0,0 +1,32 @@
+export declare const PHI_ADMIN_RUNTIME_MODULE_DEFINITION: Omit<{
+    area: "admin";
+    moduleId: "@phis/ui/modules/admin";
+    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
+    controllerType: "@phis/ui/modules/admin/controller/default";
+    controller: import("../contracts").PhiRuntimeModuleControllerDescriptor;
+    description: string;
+    category: "foundation";
+    iconFamily: string;
+    controllerMountPolicy: "area";
+    formProviders: {
+        handlers: {
+            key: `${string}/${string}`;
+            ownerModuleId: "@phis/ui/modules/admin";
+            title: string;
+            phase: "submit";
+            handlerKey: "site.admin.settings";
+            category: "site";
+            transport: "relay";
+            method: "PATCH";
+            endpointKey: null;
+            upstreamPath: string;
+            csrfPath: null;
+            requiresCsrf: false;
+            credentialPolicy: "site-session";
+        }[];
+    };
+}, "area"> & {
+    kind: "module";
+    eligibleAreas: readonly ["public" | "app" | "admin" | "builder" | "editor" | "accounting"];
+    title: "Public Base" | "App Base" | "Accounting Base" | "Admin Base" | "Builder Base" | "Editor Base";
+};

package/plugins/runtime-modules/admin/definition.js

@@ -0,0 +1,19 @@
+import { PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/admin/controller/definition";
+import { PHI_ADMIN_CONTROLLER_TYPE } from "../../../plugins/runtime-modules/admin/controller/address";
+import { buildPhiRuntimeModuleControllerDescriptor } from "../contracts";
+import { definePhiAreaBaseRuntimeModuleDefinition } from "../area-base-definition";
+import { PHI_ADMIN_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_CORE_SERVER_BINDING } from "../../../types/server-capabilities";
+import { PHI_ADMIN_SETTINGS_FORM_HANDLER_PROVIDER_DESCRIPTORS } from "../../../plugins/runtime-modules/admin/forms";
+export const PHI_ADMIN_RUNTIME_MODULE_DEFINITION = definePhiAreaBaseRuntimeModuleDefinition({
+    area: "admin",
+    moduleId: PHI_ADMIN_RUNTIME_MODULE_ID,
+    serverBinding: PHI_CORE_SERVER_BINDING,
+    controllerType: PHI_ADMIN_CONTROLLER_TYPE,
+    controller: buildPhiRuntimeModuleControllerDescriptor(PHI_ADMIN_RUNTIME_CONTROLLER_DEFINITION),
+    description: "Locked Admin Area shell, navigation surface, root route, and Admin settings.",
+    category: "foundation",
+    iconFamily: "admin",
+    controllerMountPolicy: "area",
+    formProviders: { handlers: PHI_ADMIN_SETTINGS_FORM_HANDLER_PROVIDER_DESCRIPTORS },
+});

package/plugins/runtime-modules/admin/forms.d.ts

@@ -0,0 +1,22 @@
+export declare const PHI_ADMIN_SETTINGS_FORM_IDS: {
+    readonly general: `${string}/forms/${string}`;
+};
+export declare const PHI_ADMIN_SETTINGS_FORM_HANDLER_KEYS: {
+    readonly general: "site.admin.settings";
+};
+export declare const PHI_ADMIN_RUNTIME_MODULE_FORMS: readonly [import("../contracts").PhiRuntimeModuleFormDefinition];
+export declare const PHI_ADMIN_SETTINGS_FORM_HANDLER_PROVIDER_DESCRIPTORS: {
+    key: `${string}/${string}`;
+    ownerModuleId: "@phis/ui/modules/admin";
+    title: string;
+    phase: "submit";
+    handlerKey: "site.admin.settings";
+    category: "site";
+    transport: "relay";
+    method: "PATCH";
+    endpointKey: null;
+    upstreamPath: string;
+    csrfPath: null;
+    requiresCsrf: false;
+    credentialPolicy: "site-session";
+}[];

package/plugins/runtime-modules/admin/forms.js

@@ -0,0 +1,126 @@
+import { PHI_ADMIN_RUNTIME_MODULE_ID } from "../../../plugins/runtime-modules/admin/ids";
+import { createPhiFormId } from "../../../types/form-id";
+import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
+import { flattenPhiFormLabels } from "../../../components/forms/form-labels";
+import { PHI_FORM_FIELD_PROVIDER_KEYS, PHI_FORM_VALIDATION_PROVIDER_KEYS, createPhiSharedFormProviderKey, } from "../../../components/forms/form-provider-contract";
+import { definePhiRuntimeModuleForm } from "../../../components/forms/form-registry";
+import { readPhiServerApiCredentials } from "../../../helpers/phis-server-credentials";
+export const PHI_ADMIN_SETTINGS_FORM_IDS = {
+    general: createPhiFormId(PHI_SHARED_PACKAGE_NAME, "admin/settings-general"),
+};
+export const PHI_ADMIN_SETTINGS_FORM_HANDLER_KEYS = {
+    general: "site.admin.settings",
+};
+const LABEL_SET_KEY = "@phis/ui/modules/admin/labels/settings";
+const label = (key, fallback) => ({ kind: "label", key, fallback });
+const required = (key, fallback) => ({
+    providerKey: PHI_FORM_VALIDATION_PROVIDER_KEYS.required,
+    message: label(key, fallback),
+});
+const PHI_ADMIN_SETTINGS_GENERAL_FORM_DESCRIPTOR = {
+    schemaVersion: 1,
+    key: PHI_ADMIN_SETTINGS_FORM_IDS.general,
+    labelSetKey: LABEL_SET_KEY,
+    fields: [
+        {
+            key: "name",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.text,
+            label: label("name", "Site name"),
+            autoComplete: "organization",
+            validation: [required("nameRequired", "Site name is required.")],
+        },
+        {
+            key: "hostname",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.text,
+            label: label("hostname", "Hostname"),
+            autoComplete: "off",
+            validation: [required("hostnameRequired", "Hostname is required.")],
+        },
+        {
+            key: "publicBaseUrl",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.url,
+            label: label("publicBaseUrl", "Public base URL"),
+            autoComplete: "url",
+            validation: [
+                required("publicBaseUrlRequired", "Public base URL is required."),
+                {
+                    providerKey: PHI_FORM_VALIDATION_PROVIDER_KEYS.url,
+                    message: label("publicBaseUrlInvalid", "Please provide a valid public base URL."),
+                },
+            ],
+        },
+        {
+            key: "supportEmail",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.email,
+            label: label("supportEmail", "Support email"),
+            autoComplete: "email",
+            validation: [
+                required("supportEmailRequired", "Support email is required."),
+                {
+                    providerKey: PHI_FORM_VALIDATION_PROVIDER_KEYS.email,
+                    message: label("supportEmailInvalid", "Please provide a valid support email address."),
+                },
+            ],
+        },
+    ],
+    layout: {
+        gap: { compact: "sm", medium: "base" },
+    },
+};
+async function loadLabels(context) {
+    const { getPhiAdminSettingsWidgetLabels } = await import("../../../components/widgets/label-sets/admin-settings");
+    const labels = await getPhiAdminSettingsWidgetLabels({
+        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
+        internalToken: readPhiServerApiCredentials().internalToken,
+        locale: context.runtime.locale.current,
+    });
+    return flattenPhiFormLabels({
+        name: labels.fields.siteName,
+        nameRequired: labels.fields.siteName,
+        hostname: labels.fields.hostname,
+        hostnameRequired: labels.fields.hostname,
+        publicBaseUrl: labels.fields.publicBaseUrl,
+        publicBaseUrlRequired: labels.fields.publicBaseUrl,
+        publicBaseUrlInvalid: labels.feedback.errorInvalidPublicBaseUrl,
+        supportEmail: labels.fields.supportEmail,
+        supportEmailRequired: labels.fields.supportEmail,
+        supportEmailInvalid: labels.feedback.errorInvalidSupportEmail,
+    });
+}
+export const PHI_ADMIN_RUNTIME_MODULE_FORMS = [
+    definePhiRuntimeModuleForm({
+        ownerModuleId: PHI_ADMIN_RUNTIME_MODULE_ID,
+        areas: ["admin"],
+        formId: PHI_ADMIN_SETTINGS_FORM_IDS.general,
+        version: 1,
+        flags: 0,
+        title: "General site settings",
+        description: "Site identity, public base URL, and support contact for the current site.",
+        category: "forms",
+        tags: ["settings", "site", "admin"],
+        descriptor: PHI_ADMIN_SETTINGS_GENERAL_FORM_DESCRIPTOR,
+        submitHandlerKey: PHI_ADMIN_SETTINGS_FORM_HANDLER_KEYS.general,
+        confirmHandlerKey: null,
+        previewHandlerKey: null,
+        defaultConfig: {},
+        variant: "default",
+        config: {},
+        previewUpstreamPath: null,
+        loadLabels,
+    }),
+];
+export const PHI_ADMIN_SETTINGS_FORM_HANDLER_PROVIDER_DESCRIPTORS = [{
+        key: createPhiSharedFormProviderKey("handler", "admin-settings-general"),
+        ownerModuleId: PHI_ADMIN_RUNTIME_MODULE_ID,
+        title: "Admin site settings",
+        phase: "submit",
+        handlerKey: PHI_ADMIN_SETTINGS_FORM_HANDLER_KEYS.general,
+        category: "site",
+        transport: "relay",
+        method: "PATCH",
+        endpointKey: null,
+        upstreamPath: "/api/site/admin/settings",
+        csrfPath: null,
+        requiresCsrf: false,
+        credentialPolicy: "site-session",
+    }];

package/plugins/runtime-modules/admin/ids.d.ts

@@ -0,0 +1 @@
+export declare const PHI_ADMIN_RUNTIME_MODULE_ID: "@phis/ui/modules/admin";

package/plugins/runtime-modules/admin/ids.js

@@ -0,0 +1,2 @@
+import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
+export const PHI_ADMIN_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/admin`;

package/plugins/runtime-modules/admin/module.d.ts

@@ -0,0 +1,45 @@
+export declare const PHI_ADMIN_RUNTIME_MODULE: {
+    controllerDefinition: {
+        kind: "controller";
+        pluginKey: string;
+        key: string;
+        title: string;
+        description: string;
+        iconFamily: string;
+        allowedMountScopes: "area"[];
+        runtimeSignals: {
+            emits: never[];
+            listens: never[];
+        };
+        defaultConfig: {};
+        parseConfig: () => import("../../../plugins/runtime-modules/admin/controller/definition").PhiAdminControllerConfig;
+    };
+    description: string;
+    category: "foundation";
+    iconFamily: string;
+    controller: import("../contracts").PhiRuntimeModuleControllerDescriptor;
+    moduleId: "@phis/ui/modules/admin";
+    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
+    controllerType: "@phis/ui/modules/admin/controller/default";
+    controllerMountPolicy: "area";
+    formProviders: {
+        handlers: {
+            key: `${string}/${string}`;
+            ownerModuleId: "@phis/ui/modules/admin";
+            title: string;
+            phase: "submit";
+            handlerKey: "site.admin.settings";
+            category: "site";
+            transport: "relay";
+            method: "PATCH";
+            endpointKey: null;
+            upstreamPath: string;
+            csrfPath: null;
+            requiresCsrf: false;
+            credentialPolicy: "site-session";
+        }[];
+    };
+    kind: "module";
+    eligibleAreas: readonly ["public" | "app" | "admin" | "builder" | "editor" | "accounting"];
+    title: "Public Base" | "App Base" | "Accounting Base" | "Admin Base" | "Builder Base" | "Editor Base";
+};