@fluid-app/portal-sdk 0.1.455 → 0.1.457

package/dist/index.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-9hOWP6kD.cjs");
-const require_build_widget_registry = require("./build-widget-registry-L8a9-O3A.cjs");
+const require_build_widget_registry = require("./build-widget-registry-Bg8G7GQF.cjs");
 const require_ScreenRenderer = require("./ScreenRenderer-EGk5-w0h.cjs");
 const require_use_account = require("./use-account-CPOGOGl6.cjs");
 require("./use-optional-store-CIM4spDu.cjs");
-const require_FluidProvider = require("./FluidProvider-BULkBuyn.cjs");
+const require_FluidProvider = require("./FluidProvider-Dm5QH6EP.cjs");
 require("./mysite-api-context-SWweFE49.cjs");
 require("./ContactsTranslationBridge-BvkMkPED.cjs");
-const require_ContactsScreen = require("./ContactsScreen-TO0LAuHz.cjs");
+const require_ContactsScreen = require("./ContactsScreen-Cu6-ckm9.cjs");
 require("./translation-adapter-Bi65zBvS.cjs");
 const require_PortalTenantClientProvider = require("./PortalTenantClientProvider-Ct2vdZPi.cjs");
 require("./registry-context-Dw3vg1Fz.cjs");
@@ -27,8 +27,8 @@ require("./task-composer-form-oKkUtTAg.cjs");
 const require_LayoutWidget = require("./LayoutWidget-CS8fOr1e.cjs");
 const require_registries = require("./registries-zFvhorZ2.cjs");
 require("./fields-Dj1992kh.cjs");
-const require_TextWidget = require("./TextWidget-CY71e66E.cjs");
-const require_AlertWidget = require("./AlertWidget-BJekf1r1.cjs");
+const require_TextWidget = require("./TextWidget-CNks2l1S.cjs");
+const require_AlertWidget = require("./AlertWidget-C5sAMhqU.cjs");
 const require_BulletListWidget = require("./BulletListWidget-Dz_32RH1.cjs");
 require("./preview-context-C10PndIF.cjs");
 const require_CalendarWidget = require("./CalendarWidget-Cq2SrfVW.cjs");
@@ -53,31 +53,31 @@ const require_SpacerWidget = require("./SpacerWidget-CBr--iyL.cjs");
 const require_TableWidget = require("./TableWidget-Ce6SjQ22.cjs");
 const require_ToDoWidget = require("./ToDoWidget-BFY7UXfe.cjs");
 const require_VideoWidget = require("./VideoWidget-dt8fNuTR.cjs");
-require("./ShopWidget-B9NX-1jS.cjs");
+const require_ShopWidget = require("./ShopWidget-B9NX-1jS.cjs");
 require("./translation-adapter-C-HAPTe6.cjs");
 require("./translation-adapter--Z7rT1IQ.cjs");
 const require_query_keys = require("./query-keys-COZw1P0l.cjs");
 const require_AppNavigationContext = require("./AppNavigationContext-BTP4s7dH.cjs");
 const require_use_store = require("./use-store-D89j_R7T.cjs");
 require("./dist-CeXOqY2W.cjs");
-const require_MessagingScreen = require("./MessagingScreen-DWH9xBbq.cjs");
+const require_MessagingScreen = require("./MessagingScreen-BrbkMeld.cjs");
 const require_use_navigation_parent = require("./use-navigation-parent-MoWE_Lpu.cjs");
 const require_ScreenHeaderContext = require("./ScreenHeaderContext-DFxs04W2.cjs");
 const require_CustomersScreen = require("./CustomersScreen-GUfgSu6a.cjs");
 const require_member_permissions = require("./member-permissions-DFM8-pTH.cjs");
 const require_portal_function = require("./portal-function-CiRhBwaf.cjs");
-require("./use-portal-card-add-3ds-flow-Dt29-X8z.cjs");
+require("./use-portal-card-add-3ds-flow-Cl3H-Dp7.cjs");
 require("./display-Ca4zjZd5.cjs");
 require("./use-mysite-portal-wFNLeXSG.cjs");
-const require_ProfileScreen = require("./ProfileScreen-CXqMOEza.cjs");
-const require_SubscriptionsScreen = require("./SubscriptionsScreen-Bjdz5fx-.cjs");
+const require_ProfileScreen = require("./ProfileScreen-DXSnyfCO.cjs");
+const require_SubscriptionsScreen = require("./SubscriptionsScreen-CTrOXRIz.cjs");
 require("./dist-Cpt-uZEu.cjs");
 require("./es-DgpoYsI0.cjs");
 require("./dist-BGBmj4YO.cjs");
-const require_OrdersScreen = require("./OrdersScreen-Dh_nsi8j.cjs");
+const require_OrdersScreen = require("./OrdersScreen-DKQmax51.cjs");
 const require_MySiteScreen = require("./MySiteScreen-DRFLkyJ0.cjs");
 require("./dist-DbRyOeMz.cjs");
-const require_ShopScreen = require("./ShopScreen-CrObPeSv.cjs");
+const require_ShopScreen = require("./ShopScreen-CcupxIut.cjs");
 require("./AppDownloadScreen-BUhwZtAN.cjs");
 const require_utils_build_remote_widget_plugin_manifests = require("./utils/build-remote-widget-plugin-manifests.cjs");
 let react = require("react");
@@ -1445,6 +1445,192 @@ function AccessDeniedScreen() {
 	});
 }
 //#endregion
+//#region src/core/default-property-schema-registry.ts
+const DEFAULT_PROPERTY_SCHEMA_REGISTRY = {
+	AlertWidget: require_AlertWidget.alertWidgetPropertySchema,
+	BulletListWidget: require_BulletListWidget.bulletListWidgetPropertySchema,
+	CalendarWidget: require_CalendarWidget.calendarWidgetPropertySchema,
+	CardWidget: require_CardWidget.cardWidgetPropertySchema,
+	CarouselWidget: require_CarouselWidget.carouselWidgetPropertySchema,
+	ChartWidget: require_ChartWidget.chartWidgetPropertySchema,
+	ContainerWidget: require_ContainerWidget.containerWidgetPropertySchema,
+	EmbedWidget: require_EmbedWidget.embedWidgetPropertySchema,
+	ImageWidget: require_ImageWidget.imageWidgetPropertySchema,
+	LayoutWidget: require_LayoutWidget.layoutWidgetPropertySchema,
+	LinkWidget: require_LinkWidget.linkWidgetPropertySchema,
+	ListWidget: require_ListWidget.listWidgetPropertySchema,
+	MySiteWidget: require_MySiteWidget.mySiteWidgetPropertySchema,
+	NestedWidget: require_NestedWidget.nestedWidgetPropertySchema,
+	PointsWidget: require_PointsWidget.pointsWidgetPropertySchema,
+	QuickLinksWidget: require_QuickLinksWidget.quickLinksWidgetPropertySchema,
+	QuickShareWidget: require_QuickShareWidget.quickShareWidgetPropertySchema,
+	RecentActivityWidget: require_RecentActivityWidget.recentActivityWidgetPropertySchema,
+	SeparatorWidget: require_SeparatorWidget.separatorWidgetPropertySchema,
+	ShopWidget: require_ShopWidget.shopWidgetPropertySchema,
+	SpacerWidget: require_SpacerWidget.spacerWidgetPropertySchema,
+	TableWidget: require_TableWidget.tableWidgetPropertySchema,
+	TextWidget: require_TextWidget.textWidgetPropertySchema,
+	ToDoWidget: require_ToDoWidget.toDoWidgetPropertySchema,
+	VideoWidget: require_VideoWidget.videoWidgetPropertySchema
+};
+//#endregion
+//#region src/utils/warn-unknown-widget-props.ts
+/**
+* Props every widget instance may legitimately receive that are never part
+* of a widget's own editable property schema:
+*  - Standard React/DOM pass-through props (`className`, `style`, `children`,
+*    `id`, `key`).
+*  - Structural identity props the screen-renderer pipeline injects itself
+*    for container widgets so they can support drag/select wiring
+*    (`widgetId`, `widgetPath`) — see `ScreenRenderer.tsx` in
+*    `@fluid-app/portal-widgets/core` and `WidgetContent` in
+*    `@fluid-app/portal-builder/core/widget-rendering`, which both inject
+*    these for the same widget nodes rendered here.
+* Never warn about these even though they never appear in a widget's
+* `fields` list.
+*/
+const ALWAYS_ALLOWED_WIDGET_PROPS = new Set([
+	"className",
+	"style",
+	"children",
+	"id",
+	"key",
+	"widgetId",
+	"widgetPath"
+]);
+/** Maximum Levenshtein distance for a "did you mean" suggestion to be shown. */
+const MAX_SUGGESTION_DISTANCE = 3;
+/**
+* Common authoring aliases → the canonical prop name to suggest. Levenshtein
+* only catches spelling slips; these are *semantic* misses (the motivating
+* incident authored `content` where the schema says `description` — edit
+* distance 9, far beyond any sane typo threshold). A suggestion is only shown
+* when the canonical name actually exists in the widget's schema.
+*/
+const PROP_NAME_SYNONYMS = {
+	content: "description",
+	text: "description",
+	body: "description",
+	copy: "description",
+	message: "description",
+	heading: "title",
+	header: "title",
+	label: "title"
+};
+/** `${widgetType}::${propName}` pairs already warned about this session. */
+const warnedPairs = /* @__PURE__ */ new Set();
+function isDevBuild() {
+	return {}.env?.DEV === true;
+}
+/**
+* Levenshtein edit distance between two strings. Small inline helper (no new
+* dependency) — only ever called with short widget-prop-name strings.
+*/
+function levenshteinDistance(a, b) {
+	if (a === b) return 0;
+	if (a.length === 0) return b.length;
+	if (b.length === 0) return a.length;
+	let previousRow = Array.from({ length: b.length + 1 }, (_, j) => j);
+	for (let i = 1; i <= a.length; i++) {
+		const currentRow = [i];
+		for (let j = 1; j <= b.length; j++) {
+			const substitutionCost = a[i - 1] === b[j - 1] ? 0 : 1;
+			const deletion = (previousRow[j] ?? Infinity) + 1;
+			const insertion = (currentRow[j - 1] ?? Infinity) + 1;
+			const substitution = (previousRow[j - 1] ?? Infinity) + substitutionCost;
+			currentRow.push(Math.min(deletion, insertion, substitution));
+		}
+		previousRow = currentRow;
+	}
+	return previousRow[b.length] ?? Math.max(a.length, b.length);
+}
+/**
+* Finds the suggestion for an unknown prop: a known semantic synonym first
+* (see {@link PROP_NAME_SYNONYMS}), then the nearest known key by Levenshtein
+* distance within {@link MAX_SUGGESTION_DISTANCE}.
+*/
+function findNearestKey(propName, candidates) {
+	const synonym = PROP_NAME_SYNONYMS[propName.toLowerCase()];
+	if (synonym && candidates.includes(synonym)) return synonym;
+	let nearest;
+	let nearestDistance = MAX_SUGGESTION_DISTANCE + 1;
+	for (const candidate of candidates) {
+		const distance = levenshteinDistance(propName, candidate);
+		if (distance < nearestDistance) {
+			nearestDistance = distance;
+			nearest = candidate;
+		}
+	}
+	return nearestDistance <= MAX_SUGGESTION_DISTANCE ? nearest : void 0;
+}
+/**
+* Collects every prop name a widget's property schema actually recognizes as
+* a `widget.props` key:
+*  - `borderRadius` fields are composite — their top-level `key` is a schema
+*    grouping identifier, not a real widget prop, so its four corner keys are
+*    expanded instead (mirrors `extractPropertyValues` in
+*    `@fluid-app/portal-core/registries`).
+*  - `dataSource` fields are excluded entirely. Per the same
+*    `extractPropertyValues` reference, this field type only exists so the
+*    property panel can gate other fields' visibility on whether a data
+*    source is configured — its value is read from `widget.dataSource` (the
+*    top-level, sibling-of-`props` config), never from `widget.props`.
+*    Authoring a literal `props.dataSource` is a real mistake (the config
+*    belongs one level up), so its field `key` must not be treated as an
+*    accepted prop here.
+*/
+function collectKnownPropKeys(fields) {
+	const keys = [];
+	for (const field of fields) if (field.type === "borderRadius") keys.push(...Object.values(field.keys));
+	else if (field.type !== "dataSource") keys.push(field.key);
+	return keys;
+}
+/**
+* Merges schema field keys with `dataSourceTargetProps` — props a data
+* source may populate (e.g. ListWidget's `items`) that aren't necessarily
+* declared as editable fields — into one deduped list. Used for both the
+* known/unknown check and what's surfaced to the author (the "Known props:"
+* list and suggestion candidates), so a typo of a data-source-only prop
+* still gets a correct suggestion and the valid name is actually listed.
+*/
+function collectAllKnownKeys(schema) {
+	const fieldKeys = collectKnownPropKeys(schema.fields);
+	const targetProps = schema.dataSourceTargetProps ?? [];
+	return Array.from(new Set([...fieldKeys, ...targetProps]));
+}
+/**
+* Dev-only console warning for widget props not declared in the widget's
+* registered property schema. Guards against the class of bug where an
+* authored screen sets a prop the widget doesn't know about (typo'd name,
+* stale field from a prior schema version) — the prop is silently dropped
+* and the widget renders its placeholder defaults with no signal to the
+* author.
+*
+* No-ops entirely outside a Vite dev build (checked first, before any prop
+* iteration, so there's zero overhead in production bundles) and for widget
+* types with no registered schema (custom/company widgets) — there's nothing
+* to validate against, so we skip silently rather than warn.
+*
+* Warns at most once per (widgetType, propName) pair per session.
+*/
+function warnUnknownWidgetProps({ widgetType, props, registry }) {
+	if (!isDevBuild()) return;
+	const schema = registry[widgetType];
+	if (!schema) return;
+	const knownKeys = collectAllKnownKeys(schema);
+	const knownKeySet = new Set(knownKeys);
+	for (const propName of Object.keys(props)) {
+		if (knownKeySet.has(propName)) continue;
+		if (ALWAYS_ALLOWED_WIDGET_PROPS.has(propName)) continue;
+		const pairKey = `${widgetType}::${propName}`;
+		if (warnedPairs.has(pairKey)) continue;
+		warnedPairs.add(pairKey);
+		const suggestion = findNearestKey(propName, knownKeys);
+		const suggestionText = suggestion ? ` Did you mean "${suggestion}"?` : "";
+		console.warn(`[portal] ${widgetType} received unknown prop "${propName}" — not in its schema.${suggestionText} Known props: ${knownKeys.join(", ")}.`);
+	}
+}
+//#endregion
 //#region src/shell/BuilderScreenView.tsx
 /**
 * BuilderScreenView — renders a builder screen's component_tree with
@@ -1462,6 +1648,11 @@ function WidgetRenderer({ widget, index }) {
 		console.warn(`[BuilderScreenView] Widget type "${String(widget.type)}" not found in registry`);
 		return null;
 	}
+	if (require_build_widget_registry.isDefaultWidgetComponent(widget.type, Component)) warnUnknownWidgetProps({
+		widgetType: widget.type,
+		props: widget.props,
+		registry: DEFAULT_PROPERTY_SCHEMA_REGISTRY
+	});
 	if (widget.dataSource) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		className: "h-full w-full overflow-x-hidden",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_ScreenRenderer.DataAwareWidget, {
@@ -1524,12 +1715,12 @@ function resolveMemberTypePage(registry, memberTypeSlug, currentSlug, baseSlug)
 }
 //#endregion
 //#region src/shell/system-screen-map.ts
-const ProfileScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ProfileScreen-t2V-W4Dv.cjs")).then((m) => ({ default: m.ProfileScreen })));
-const OrdersScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./OrdersScreen-CfchcnYB.cjs")).then((m) => ({ default: m.OrdersScreen })));
-const SubscriptionsScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./SubscriptionsScreen-BlB3Ppoa.cjs")).then((m) => ({ default: m.SubscriptionsScreen })));
-const MessagingScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./MessagingScreen-B_nyIg2b.cjs")).then((m) => ({ default: m.MessagingScreen })));
-const ContactsScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ContactsScreen-DsHXXYfF.cjs")).then((m) => ({ default: m.ContactsScreen })));
-const ShopScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ShopScreen-BWDYXw4Q.cjs")).then((m) => ({ default: m.ShopScreen })));
+const ProfileScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ProfileScreen-B5DcNq7i.cjs")).then((m) => ({ default: m.ProfileScreen })));
+const OrdersScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./OrdersScreen-UaQcR3IU.cjs")).then((m) => ({ default: m.OrdersScreen })));
+const SubscriptionsScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./SubscriptionsScreen-DdlwKkJ1.cjs")).then((m) => ({ default: m.SubscriptionsScreen })));
+const MessagingScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./MessagingScreen-uuydnJEi.cjs")).then((m) => ({ default: m.MessagingScreen })));
+const ContactsScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ContactsScreen-BTCUeDHl.cjs")).then((m) => ({ default: m.ContactsScreen })));
+const ShopScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ShopScreen-DH_TcNMs.cjs")).then((m) => ({ default: m.ShopScreen })));
 const CustomersScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./CustomersScreen-sUkFLvP2.cjs")).then((m) => ({ default: m.CustomersScreen })));
 const ShareablesScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./ShareablesScreen-DAKdATIv.cjs")).then((m) => ({ default: m.ShareablesScreen })));
 const MySiteScreen$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("./MySiteScreen-DMTwqS2r.cjs")).then((m) => ({ default: m.MySiteScreen })));
@@ -3437,15 +3628,15 @@ const CORE_PAGE_IDS = {
 //#endregion
 //#region src/screens/index.ts
 const screenPropertySchemas = {
-	ProfileScreen: () => Promise.resolve().then(() => require("./ProfileScreen-t2V-W4Dv.cjs")).then((m) => m.profileScreenPropertySchema),
-	MessagingScreen: () => Promise.resolve().then(() => require("./MessagingScreen-B_nyIg2b.cjs")).then((m) => m.messagingScreenPropertySchema),
-	ContactsScreen: () => Promise.resolve().then(() => require("./ContactsScreen-DsHXXYfF.cjs")).then((m) => m.contactsScreenPropertySchema),
-	OrdersScreen: () => Promise.resolve().then(() => require("./OrdersScreen-CfchcnYB.cjs")).then((m) => m.ordersScreenPropertySchema),
-	SubscriptionsScreen: () => Promise.resolve().then(() => require("./SubscriptionsScreen-BlB3Ppoa.cjs")).then((m) => m.subscriptionsScreenPropertySchema),
+	ProfileScreen: () => Promise.resolve().then(() => require("./ProfileScreen-B5DcNq7i.cjs")).then((m) => m.profileScreenPropertySchema),
+	MessagingScreen: () => Promise.resolve().then(() => require("./MessagingScreen-uuydnJEi.cjs")).then((m) => m.messagingScreenPropertySchema),
+	ContactsScreen: () => Promise.resolve().then(() => require("./ContactsScreen-BTCUeDHl.cjs")).then((m) => m.contactsScreenPropertySchema),
+	OrdersScreen: () => Promise.resolve().then(() => require("./OrdersScreen-UaQcR3IU.cjs")).then((m) => m.ordersScreenPropertySchema),
+	SubscriptionsScreen: () => Promise.resolve().then(() => require("./SubscriptionsScreen-DdlwKkJ1.cjs")).then((m) => m.subscriptionsScreenPropertySchema),
 	CustomersScreen: () => Promise.resolve().then(() => require("./CustomersScreen-sUkFLvP2.cjs")).then((m) => m.customersScreenPropertySchema),
 	MySiteScreen: () => Promise.resolve().then(() => require("./MySiteScreen-DMTwqS2r.cjs")).then((m) => m.mySiteScreenPropertySchema),
 	ShareablesScreen: () => Promise.resolve().then(() => require("./ShareablesScreen-DAKdATIv.cjs")).then((m) => m.shareablesScreenPropertySchema),
-	ShopScreen: () => Promise.resolve().then(() => require("./ShopScreen-BWDYXw4Q.cjs")).then((m) => m.shopScreenPropertySchema),
+	ShopScreen: () => Promise.resolve().then(() => require("./ShopScreen-DH_TcNMs.cjs")).then((m) => m.shopScreenPropertySchema),
 	AppDownloadScreen: () => Promise.resolve().then(() => require("./AppDownloadScreen-BUhwZtAN.cjs")).then((n) => n.AppDownloadScreen_exports).then((m) => m.appDownloadScreenPropertySchema)
 };
 /**