@controleonline/ui-common 1.2.90 → 1.2.91

package/docs/compact-order-history-1047.md

@@ -0,0 +1,25 @@
+# DefaultTable compact pilot — app-community #1047
+
+The compact appearance is opt-in. Order History is the pilot; default consumers retain their existing appearance and actions. Search, controlled filters, accessible card sorting, column visibility, table/cards, numbered pagination and report totals reuse the shared table and order services.
+
+Theme authority remains the main company/domain. Theme tokens override status colors; registered status.color follows; neutral theme text is last. Franchise switching does not override domain authority. No database writes or staging Theme bindings are shipped. Business permissions, payment/cancellation eligibility and request/security filters are preserved.
+
+Header logos send authentication only to the exact API origin; external images use Image without headers. Inline row/card navigation stays blocked during editing/saving, preserving existing store save callbacks. Provider extraction preserves hook order and unrelated bootstrap dependencies, checked by ordered AST fingerprints.
+
+Pre-existing published dependencies are merged by their exact gitHeads rather than importing latest dev:
+- ui-default 1.0.276 f0083eb73074f402e81f4e0c832af0bb829c2047; published patch277 1dff39dc32be3320cd4a786baf5621e8a2d3ac00.
+- ui-orders 1.3.42 bfe2f013dc9bcaf033ba0db80894f021bfb2fbfb.
+- ui-layout 1.0.15 37f1dff3fecf1f08bc8846a319af83c9fcbff502.
+- ui-common 1.2.89 4919724c04f3d6e66280db4c9e2a66db65c47cc0; published patch90 e19f14d4afefb89a0700d63753785815364af835.
+
+Patch90 Connections.js had an unterminated searchKey quote. Only that quote is repaired to make the retained published fixes compilable. Existing DefaultTable tests are split without discarding cases; fixtures now model reactive stores, company-scoped preferences, route context and CSS sticky positioning. Legacy toolbar tests isolate the inactive compact branch; dedicated compact suites cover its controls.
+
+Validation: 135 assertions in 22 suites, 591 React files parsed, and isolated Expo web export (5492 modules). These are source/composition checks; authenticated staging validation remains a separate promotion gate. Isolation used source-module copies; final released-package pins must be verified again by release validation.
+
+From app-community with installed release packages:
+```sh
+node scripts/validate-compact-sources.cjs
+node node_modules/jest/bin/jest.js --config jest.compact.config.cjs --maxWorkers=2 --testPathPattern='compact|Compact|headerLogoProtocol|DefaultCompanyHeaderLogo|useDefaultTableStoreSync|providerEffects|DefaultProviderAuthority|deviceConfigBootstrap|mercadoLivreIntegrationHelpers|DefaultTable\.(group[123]\.)?test.js|OrderHistoryPage.test.js|DefaultTableCards.layout|DefaultTableToolbar.waiter'
+```
+
+For isolated sibling source clones, set CONTROLEONLINE_MODULES_ROOT to their common directory. The committed configuration has no machine-specific absolute path. Published versions planned: ui-default1.0.278, ui-orders1.3.43, ui-layout1.0.16, ui-common1.2.91.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@controleonline/ui-common",
-  "version": "1.2.90",
+  "version": "1.2.91",
   "author": "ControleOnline",
   "description": "ControleOnline Common Quasar UI Component",
   "license": "MIT",

package/src/react/components/DefaultProvider.native.configuration.js

@@ -0,0 +1,275 @@
+import {useEffect} from 'react';
+
+// Extracted bootstrap effects retain their dependency arrays and invocation order.
+
+export function useNativeDeviceConfigSync({deviceConfigFetched, isLogged, deviceConfigPeopleIri, device, deviceRuntimeConfigSynced, runtimeDeviceType, device_config, buildDefaultDeviceConfigs, buildProviderManagedDeviceConfigs, appVersion, setDeviceRuntimeConfigSynced, deviceConfigsActions, user}) {
+  useEffect(() => {
+    if (
+      !deviceConfigFetched ||
+      !isLogged ||
+      !deviceConfigPeopleIri ||
+      !device?.id ||
+      deviceRuntimeConfigSynced
+    ) {
+      return;
+    }
+
+    const isNewPdvConfig =
+      runtimeDeviceType === 'PDV' &&
+      !device_config?.id &&
+      !device_config?.['@id'];
+    const buildDeviceConfigs = isNewPdvConfig
+      ? buildDefaultDeviceConfigs
+      : buildProviderManagedDeviceConfigs;
+    const {nextConfigs, needsUpdate} = buildDeviceConfigs({
+      configs: device_config?.configs,
+      appVersion,
+      deviceInfo: device,
+    });
+
+    if (!needsUpdate) {
+      setDeviceRuntimeConfigSynced(true);
+      return;
+    }
+
+    // app-community#821: never auto-persist device_config from global bootstrap.
+    // Provider-managed fields stay in memory only; API mutations only from
+    // explicit device settings UI (avoids 403 on order-history / PDV|MANAGER).
+    const currentItem = device_config || {};
+    deviceConfigsActions.setItem({
+      ...currentItem,
+      configs: nextConfigs,
+      device: currentItem.device || device.id,
+      people: currentItem.people || deviceConfigPeopleIri,
+      type: currentItem.type || runtimeDeviceType,
+    });
+    setDeviceRuntimeConfigSynced(true);
+  }, [
+    appVersion,
+    device?.id,
+    device?.manufacturer,
+    device?.isEmulator,
+    deviceConfigFetched,
+    deviceConfigPeopleIri,
+    deviceRuntimeConfigSynced,
+    deviceConfigsActions,
+    device_config,
+    isLogged,
+    runtimeDeviceType,
+    user,
+  ]);
+}
+
+export function useNativeMainConfigReset({isLogged, currentCompany, device, setMainConfigsDiscovered}) {
+  useEffect(() => {
+    if (!isLogged || !currentCompany?.id || !device?.id) {
+      return;
+    }
+
+    setMainConfigsDiscovered(false);
+  }, [isLogged, currentCompany?.id, device?.id]);
+}
+
+export function useNativeMainConfigDiscovery({isLogged, currentCompany, device, mainConfigsDiscovered, configActions, setMainConfigsDiscovered}) {
+  useEffect(() => {
+    if (
+      !isLogged ||
+      !currentCompany?.id ||
+      !device?.id ||
+      mainConfigsDiscovered
+    ) {
+      return;
+    }
+
+    configActions
+      .discoveryMainConfigs({
+        people: '/people/' + currentCompany.id,
+      })
+      .catch(() => {})
+      .finally(() => {
+        setMainConfigsDiscovered(true);
+      });
+  }, [configActions, currentCompany?.id, device?.id, isLogged, mainConfigsDiscovered]);
+}
+
+export function useNativeMainConfigSeed({isLogged, currentCompany, mainConfigsDiscovered, configActions}) {
+  useEffect(() => {
+    if (
+      isLogged &&
+      currentCompany &&
+      Object.entries(currentCompany).length > 0 &&
+      !mainConfigsDiscovered
+    ) {
+      configActions.setItems(currentCompany.configs);
+    }
+  }, [currentCompany, isLogged, mainConfigsDiscovered]);
+}
+
+export function useNativeTranslationBootstrap({currentRouteName, isPublicRouteActive, isLogged, hasCurrentCompany, deviceConfigFetched, expectedTranslateBootstrapKey, translateBootstrapKeyRef, companies, currentCompany, mainCompany, setActiveTranslateBootstrapKey, setTranslateReady, configuredTranslationLanguage, Translate, stores, translateStore}) {
+  useEffect(() => {
+    if (!currentRouteName || isPublicRouteActive) {
+      return;
+    }
+
+    if (
+      !isLogged ||
+      !hasCurrentCompany ||
+      !deviceConfigFetched ||
+      !expectedTranslateBootstrapKey
+    ) {
+      return;
+    }
+
+    const currentConfig = JSON.parse(localStorage.getItem('config') || '{}');
+
+    if (
+      translateBootstrapKeyRef.current === expectedTranslateBootstrapKey &&
+      global.t
+    ) {
+      global.t.companies = companies;
+      global.t.currentCompany = currentCompany;
+      global.t.mainCompany = mainCompany;
+      setActiveTranslateBootstrapKey(expectedTranslateBootstrapKey);
+      setTranslateReady(true);
+
+      return;
+    }
+
+    setTranslateReady(false);
+
+    if (currentConfig.language !== configuredTranslationLanguage) {
+      const nextConfig = {
+        ...currentConfig,
+        language: configuredTranslationLanguage,
+      };
+      localStorage.setItem(
+        'config',
+        JSON.stringify(nextConfig),
+      );
+    }
+
+    translateBootstrapKeyRef.current = expectedTranslateBootstrapKey;
+    global.t = new Translate(
+      companies,
+      mainCompany,
+      currentCompany,
+      Object.keys(stores),
+      translateStore,
+    );
+    setActiveTranslateBootstrapKey(expectedTranslateBootstrapKey);
+    setTranslateReady(true);
+    global.refreshTranslationsUI?.();
+  }, [
+    companies,
+    configuredTranslationLanguage,
+    currentCompany,
+    currentRouteName,
+    mainCompany,
+    deviceConfigFetched,
+    expectedTranslateBootstrapKey,
+    hasCurrentCompany,
+    isLogged,
+    isPublicRouteActive,
+    translateStore,
+  ]);
+}
+
+export function useNativeBootstrapReady({isLogged, hasCurrentCompany, currentRouteName, isTranslateBootstrapReady, onBootstrapReady}) {
+  useEffect(() => {
+    if (
+      !isLogged ||
+      !hasCurrentCompany ||
+      (currentRouteName && isTranslateBootstrapReady)
+    ) {
+      onBootstrapReady?.();
+    }
+  }, [
+    currentRouteName,
+    hasCurrentCompany,
+    isLogged,
+    isTranslateBootstrapReady,
+    onBootstrapReady,
+  ]);
+}
+
+export function useNativeCompanies({device, isLogged, peopleActions}) {
+  useEffect(() => {
+    if (
+      device &&
+      device.id &&
+      isLogged
+    ) {
+      peopleActions.myCompanies();
+    }
+  }, [isLogged, device?.id]);
+}
+
+export function useNativeMenus({isLogged, currentCompany, actions, api, appType, normalizeRuntimeMenuResponse}) {
+  useEffect(() => {
+    if (!isLogged || !currentCompany?.id) {
+      actions.setMenus([]);
+      return undefined;
+    }
+
+    let cancelled = false;
+
+    api
+      .fetch('menus-people', {
+        params: {
+          myCompany: currentCompany.id,
+          appType,
+          menuType: 'home',
+        },
+      })
+      .then(result => {
+        if (!cancelled) {
+          actions.setMenus(normalizeRuntimeMenuResponse(result, {appType}));
+        }
+      })
+      .catch(() => {
+        if (!cancelled) {
+          actions.setMenus(normalizeRuntimeMenuResponse(null, {appType}));
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [actions, appType, currentCompany?.id, isLogged]);
+}
+
+export function useNativeThemeFetch({api, parseThemeCss, setBaseThemeColors, actions, device, currentCompany, mainCompany}) {
+  useEffect(() => {
+    const fetchColors = async () => {
+      try {
+        const cssText = await api.fetch('themes-colors.css', {
+          responseType: 'text',
+        });
+        const parsedColors = parseThemeCss(cssText);
+        setBaseThemeColors(parsedColors);
+        actions.setColors(parsedColors);
+      } catch {
+        setBaseThemeColors({});
+      }
+    };
+
+    if (device?.id) {
+      fetchColors();
+    }
+  }, [actions, currentCompany?.id, mainCompany?.id, device?.id]);
+}
+
+export function useNativeThemePalette({resolveDomainThemeColors, baseThemeColors, mainCompany, resolveThemePalette, runtimeColors, applyPaletteToRuntimeColors, applyThemeCssVariables, actions, currentCompany}) {
+  useEffect(() => {
+    const mergedThemeColors = resolveDomainThemeColors(baseThemeColors, mainCompany);
+
+    const palette = resolveThemePalette(mergedThemeColors, runtimeColors);
+    applyPaletteToRuntimeColors(palette, runtimeColors);
+    applyThemeCssVariables({
+      themeColors: mergedThemeColors,
+      palette,
+    });
+
+    actions.setColors(mergedThemeColors);
+  }, [actions, baseThemeColors, currentCompany?.id, currentCompany?.theme?.colors]);
+}