@phis/ui 0.4.1 → 0.4.3

package/plugins/runtime-modules/core/widgets/result/config.d.ts

@@ -1,3 +1,4 @@
+import { type PhiTextSource } from "../../../../../helpers/text-source";
 import { type PhiCmsWidgetConfigBase } from "../../../../../components/widgets/config/parser-primitives";
 import type { PhiResultWidgetVisualStatus } from "../../../../../types/result-widget";
 export type PhiCmsResultWidgetConfig = PhiCmsWidgetConfigBase & {
@@ -7,6 +8,8 @@ export type PhiCmsResultWidgetConfig = PhiCmsWidgetConfigBase & {
     subTitle?: string;
     homeLink?: boolean;
     homeLinkLabel?: string;
+    /** Whose words `title`, `subTitle` and `homeLinkLabel` are (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 /**
  * The way out of a result that ended a journey.
@@ -315,30 +318,6 @@ export declare const PHI_RESULT_WIDGET_DEFINITION: {
         editorPlacement?: "inspector" | "geometry" | "toolbar";
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
-    } & {
-        type: "background";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
-    } & {
-        type: "border";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
     } & {
         type: "surface";
         tone?: false;
@@ -351,7 +330,7 @@ export declare const PHI_RESULT_WIDGET_DEFINITION: {
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
     } & {
-        type: "shadow" | "grid-placement" | "column-count";
+        type: "grid-placement" | "column-count";
         section?: string;
     }) | {
         key: string;

package/plugins/runtime-modules/core/widgets/result/config.js

@@ -1,5 +1,6 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
 import { PHI_RENDERABLE_BLOCK_GEOMETRY_FIELDS } from "../../../../../helpers/renderable-block-plugin-fields";
+import { readPhiTextSource } from "../../../../../helpers/text-source";
 import { readBoolean, readRenderableBlockConfig, readString, } from "../../../../../components/widgets/config/parser-primitives";
 /**
  * The way out of a result that ended a journey.
@@ -36,6 +37,7 @@ function parsePhiCmsResultWidgetConfig(config) {
         subTitle: readString(config.subTitle),
         homeLink: readBoolean(config.homeLink) ?? true,
         homeLinkLabel: readString(config.homeLinkLabel),
+        textSource: readPhiTextSource(config.textSource),
     };
 }
 export const PHI_RESULT_WIDGET_DEFINITION = {

package/plugins/runtime-modules/core/widgets/result/server.js

@@ -1,37 +1,43 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { PHI_TR_CTX_WEB_UI_LABEL, createSiteTranslator } from "../../../../../gateway/tr";
+import { trWidgetText } from "../../../../../server-helpers/translate";
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../../helpers/text-source";
 import { PHI_RESULT_HOME_LINK_SOURCE_LABEL } from "./config";
 import { localizeAreaPath } from "../../../../../helpers/locale";
 import { PhiResultWidgetBody } from "../../../../../components/widgets/shared/result-body";
-import { readPhiServerApiCredentials } from "../../../../../helpers/phis-server-credentials";
+/**
+ * The Result's words, each from the store of whoever wrote it (`helpers/text-source.ts`).
+ *
+ * A Preset's title and subtitle -- the error pages' "Not found" -- are the platform's and come from the
+ * global store; an author's are the Site's. The home link's default label is the Widget's own sentence,
+ * so it is the platform's whoever placed the Widget.
+ */
 async function resolveResultText({ config, runtime, translate }) {
     const code = config?.code?.trim();
     const title = config?.title?.trim();
     const subTitle = config?.subTitle?.trim();
-    const homeLinkLabel = config?.homeLinkLabel?.trim() || PHI_RESULT_HOME_LINK_SOURCE_LABEL;
+    const authoredHomeLinkLabel = config?.homeLinkLabel?.trim();
+    const homeLinkLabel = authoredHomeLinkLabel || PHI_RESULT_HOME_LINK_SOURCE_LABEL;
     const shouldTranslate = translate &&
         config?.renderMode !== "preview" &&
-        config?.renderMode !== "editor" &&
-        Boolean(readPhiServerApiCredentials().apiBaseUrl.trim()) &&
-        Boolean(readPhiServerApiCredentials().internalToken.trim()) &&
-        Boolean(runtime.site.key.trim()) &&
-        Boolean(runtime.locale.current.trim());
+        config?.renderMode !== "editor";
     if (!shouldTranslate) {
         return { code, title, subTitle, homeLinkLabel };
     }
-    const translator = createSiteTranslator({
-        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
-        internalToken: readPhiServerApiCredentials().internalToken,
-        siteKey: runtime.site.key,
-        locale: runtime.locale.current,
-    });
-    const sourceTexts = [title ?? "", subTitle ?? "", homeLinkLabel];
-    const translated = await translator.trBulk(sourceTexts, PHI_TR_CTX_WEB_UI_LABEL);
+    const locale = runtime.locale.current;
+    const textSource = config?.textSource;
+    const translateText = async (value) => value ? (await trWidgetText(locale, value, textSource)).trim() || value : value;
+    const [translatedTitle, translatedSubTitle, translatedHomeLinkLabel] = await Promise.all([
+        translateText(title),
+        translateText(subTitle),
+        authoredHomeLinkLabel
+            ? translateText(authoredHomeLinkLabel)
+            : trWidgetText(locale, PHI_RESULT_HOME_LINK_SOURCE_LABEL, PHI_TEXT_SOURCE_PRESET),
+    ]);
     return {
         code,
-        title: translated[0]?.trim() || title,
-        subTitle: translated[1]?.trim() || subTitle,
-        homeLinkLabel: translated[2]?.trim() || homeLinkLabel,
+        title: translatedTitle,
+        subTitle: translatedSubTitle,
+        homeLinkLabel: translatedHomeLinkLabel?.trim() || homeLinkLabel,
     };
 }
 export async function PhiResultWidget({ config, runtime, translate }) {

package/plugins/runtime-modules/core/widgets/simple-text/config.d.ts

@@ -323,30 +323,6 @@ export declare const PHI_SIMPLE_TEXT_WIDGET_DEFINITION: {
         editorPlacement?: "inspector" | "geometry" | "toolbar";
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
-    } & {
-        type: "background";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
-    } & {
-        type: "border";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
     } & {
         type: "surface";
         tone?: false;
@@ -359,7 +335,7 @@ export declare const PHI_SIMPLE_TEXT_WIDGET_DEFINITION: {
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
     } & {
-        type: "shadow" | "grid-placement" | "column-count";
+        type: "grid-placement" | "column-count";
         section?: string;
     }) | {
         key: string;

package/plugins/runtime-modules/core/widgets/slot-upload/client.js

@@ -8,7 +8,7 @@ import { usePhiMediaUpload } from "../../../../../components/media/phi-media-upl
 import { runPhiAddonAssetUpload, } from "../../../../../components/media/media-upload-flow";
 import { PHI_MEDIA_UPLOAD_DEFAULT_LABELS } from "../../../../../components/media/phi-media-upload";
 import { usePhiSignalListener } from "../../../../../components/runtime/runtime-signal-bus";
-import { usePhiSignalIdentity } from "../../../../../components/runtime/runtime-signal-identity";
+import { emitPhiSignalCapability, usePhiSignalEmitter, usePhiSignalIdentity, } from "../../../../../components/runtime/runtime-signal-identity";
 import { readPhiTableBindingParamsSignalValue } from "../../../../../types/table-signal-values";
 import { findPhiSignalListenRoute } from "../../../../../helpers/signal-listen-routes";
 import { PhiFlexControl } from "../../../../../components/controls/phi-flex-control";
@@ -21,6 +21,13 @@ export function PhiSlotUploadWidgetClient({ config }) {
     const ownerParam = config?.ownerParam?.trim() || "id";
     const signalIdentity = usePhiSignalIdentity();
     const listenRoutes = useMemo(() => config?.signalRoutes?.listens ?? [], [config?.signalRoutes?.listens]);
+    const emitRoutes = useMemo(() => config?.signalRoutes?.emits ?? [], [config?.signalRoutes?.emits]);
+    const emitSignal = usePhiSignalEmitter();
+    /*
+     * The row's files changed -- a file arrived or went -- so whatever shows the row can read it again.
+     * Sent only once the change is through, never for an upload that was refused or a removal that failed.
+     */
+    const announceChanged = useCallback(() => emitPhiSignalCapability(emitSignal, emitRoutes, "changed", null), [emitRoutes, emitSignal]);
     const [ownerId, setOwnerId] = useState(null);
     const [slot, setSlot] = useState(null);
     /*
@@ -176,6 +183,7 @@ export function PhiSlotUploadWidgetClient({ config }) {
         runSession,
         onUploaded: async () => {
             setFailure(null);
+            announceChanged();
             await reload();
         },
         onRejected: (message) => setFailure(message),
@@ -196,8 +204,9 @@ export function PhiSlotUploadWidgetClient({ config }) {
             setFailure("That file stayed.");
             return;
         }
+        announceChanged();
         await reload();
-    }, [base, ownerId, read, reload]);
+    }, [announceChanged, base, ownerId, read, reload]);
     if (!base || !slotName) {
         return _jsx(PhiTypographyControl, { type: "secondary", children: "This field names no Add-on, table or slot." });
     }

package/plugins/runtime-modules/core/widgets/table/client.js

@@ -306,7 +306,7 @@ export function PhiTableWidgetClient({ config: inputConfig, externalSearch, exte
         },
         validateResource,
     });
-    const { resource, bindingError, contractError, rows, total, summary, loading, error, query, resolvedQuery, setQuery, selectedRowIdentities, setSelectedRowIdentities, expandedRowIdentities, setExpandedRowIdentities, reload, executeAction, commitField, commitRow, isFieldMutationPending, moveRow, drop, } = binding;
+    const { resource, bindingError, contractError, rows, total, hasMore, summary, loading, error, query, resolvedQuery, setQuery, selectedRowIdentities, setSelectedRowIdentities, expandedRowIdentities, setExpandedRowIdentities, reload, executeAction, commitField, commitRow, isFieldMutationPending, moveRow, drop, } = binding;
     const toolbarActions = useMemo(() => resolveTableActions(features.actions?.toolbar, resource?.actions), [features.actions?.toolbar, resource?.actions]);
     const rowActions = useMemo(() => resolveTableActions(features.actions?.row, resource?.actions), [features.actions?.row, resource?.actions]);
     const bulkActions = useMemo(() => resolveTableActions(features.actions?.bulk, resource?.actions), [features.actions?.bulk, resource?.actions]);
@@ -564,7 +564,7 @@ export function PhiTableWidgetClient({ config: inputConfig, externalSearch, exte
     }, [emitCapability, resolvedQuery]);
     useEffect(() => {
         const state = {
-            total,
+            total: total ?? undefined,
             page: resolvedQuery.page,
             pageSize: resolvedQuery.pageSize,
             loading: effectiveLoading,
@@ -667,14 +667,17 @@ export function PhiTableWidgetClient({ config: inputConfig, externalSearch, exte
     const resolveSummaryValue = useCallback((item) => {
         if (item.value.source === "provider")
             return summary[item.value.fieldKey];
+        // Without a count the Provider gives, there is none to show: the rows of this page are not it.
         if (item.value.fieldKey === "totalRows")
-            return total;
+            return total ?? undefined;
         if (item.value.fieldKey === "pageRows")
             return rows.length;
         if (item.value.fieldKey === "selectedRows")
             return selectedRowIdentities.length;
         if (item.value.fieldKey === "page")
             return resolvedQuery.page ?? 1;
+        if (total == null)
+            return undefined;
         const pageSize = resolvedQuery.pageSize ?? rows.length;
         return pageSize > 0 ? Math.ceil(total / pageSize) : 0;
     }, [resolvedQuery.page, resolvedQuery.pageSize, rows.length, selectedRowIdentities.length, summary, total]);
@@ -824,7 +827,8 @@ export function PhiTableWidgetClient({ config: inputConfig, externalSearch, exte
                 } : undefined, pagination: features.pagination?.enabled === false ? false : {
                     page: resolvedQuery.page ?? 1,
                     pageSize: resolvedQuery.pageSize ?? 20,
-                    total,
+                    total: total ?? undefined,
+                    hasMore,
                     pageSizeOptions: features.pagination?.pageSizes,
                     showSizeChanger: (features.pagination?.pageSizes?.length ?? 0) > 0,
                     onChange: (page, pageSize) => setQuery((current) => ({ ...current, page, pageSize, cursor: null })),

package/plugins/runtime-modules/core/widgets/table/config.d.ts

@@ -346,30 +346,6 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
         editorPlacement?: "inspector" | "geometry" | "toolbar";
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
-    } & {
-        type: "background";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
-    } & {
-        type: "border";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    }) | ({
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
-        heading?: string;
     } & {
         type: "surface";
         tone?: false;
@@ -382,7 +358,7 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
         visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
         heading?: string;
     } & {
-        type: "shadow" | "grid-placement" | "column-count";
+        type: "grid-placement" | "column-count";
         section?: string;
     }) | {
         visibleWhen: {
@@ -700,34 +676,6 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
         reorderable?: boolean;
         presentation?: import("../../../../../types").PhiCmsConfigFieldCollectionPresentation;
         editLabel?: string;
-    } | {
-        visibleWhen: {
-            field: string;
-            notEquals: string;
-        };
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        heading?: string;
-        type: "background";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-    } | {
-        visibleWhen: {
-            field: string;
-            notEquals: string;
-        };
-        key: string;
-        label: string;
-        description?: string;
-        required?: boolean;
-        editorPlacement?: "inspector" | "geometry" | "toolbar";
-        heading?: string;
-        type: "border";
-        section?: string;
-        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
     } | {
         visibleWhen: {
             field: string;
@@ -752,7 +700,7 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
         required?: boolean;
         editorPlacement?: "inspector" | "geometry" | "toolbar";
         heading?: string;
-        type: "shadow" | "grid-placement" | "column-count";
+        type: "grid-placement" | "column-count";
         section?: string;
     } | {
         key: string;
@@ -1093,34 +1041,6 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
             reorderable?: boolean;
             presentation?: import("../../../../../types").PhiCmsConfigFieldCollectionPresentation;
             editLabel?: string;
-        } | {
-            visibleWhen: {
-                field: string;
-                equals: boolean;
-            };
-            key: string;
-            label: string;
-            description?: string;
-            required?: boolean;
-            editorPlacement?: "inspector" | "geometry" | "toolbar";
-            heading?: string;
-            type: "background";
-            section?: string;
-            storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
-        } | {
-            visibleWhen: {
-                field: string;
-                equals: boolean;
-            };
-            key: string;
-            label: string;
-            description?: string;
-            required?: boolean;
-            editorPlacement?: "inspector" | "geometry" | "toolbar";
-            heading?: string;
-            type: "border";
-            section?: string;
-            storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
         } | {
             visibleWhen: {
                 field: string;
@@ -1145,7 +1065,7 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
             required?: boolean;
             editorPlacement?: "inspector" | "geometry" | "toolbar";
             heading?: string;
-            type: "shadow" | "grid-placement" | "column-count";
+            type: "grid-placement" | "column-count";
             section?: string;
         } | {
             key: string;