@zexsoft/fix-core 1.14.15 → 1.14.16-staging

package/README.md

@@ -239,6 +239,7 @@ the route of its list (records link to `${route}/{id}`), defaulting to the FIX a
 |---|---|---|
 | `AccountPage` | — | `docsUrl` (FIX API docs, default `/docs`), `loginRoute` (default `/login`) |
 | `CompanyPage`, `TeamPage` | — | |
+| `PreferencesPage` | — | `fixApps` (FIX Fiscal app updates/downloads and version, default on) |
 | `InvoicePage` | `/invoicing/invoices`, `/invoicing/expenses` | `isReceived` (expenses) |
 | `ItemPage`, `PricingRulePage`, `DocumentSeriesPage`, `ItemTagPage`, `ItemUnitPage` | `/catalog/…` | |
 | `FiscalEntityPage`, `BankAccountPage`, `EntityBranchPage` | `/partners/…` | |

package/dist/pages/PreferencesPage.svelte

@@ -0,0 +1,292 @@
+<script lang="ts">import { Icon } from "iconify-static";
+import { mode, setMode } from "mode-watcher";
+import AppDownloadCard from "../components/domain/AppDownload/AppDownloadCard.svelte";
+import { afterOverlaysSettle } from "../components/ui/back-dismiss/BackDismiss.svelte";
+import { Button } from "../components/ui/button/index.js";
+import * as Card from "../components/ui/card/index.js";
+import * as Field from "../components/ui/field/index.js";
+import { PageHeading } from "../components/ui/page-heading";
+import * as Select from "../components/ui/select/index.js";
+import { toast } from "../components/ui/sonner/index.js";
+import * as Switch from "../components/ui/switch/index.js";
+import ZexsoftLogo from "../components/ui/wordmark/zexsoftLogo.svelte";
+import { t } from "../core/fix-core.svelte.js";
+import { getLocale, isLocale, setLocale } from "../paraglide/runtime";
+import { appUpdate } from "../stores/app-update.svelte.js";
+import { deviceStore } from "../stores/device-store.svelte.js";
+import { IsMobile } from "../utils/is-mobile.svelte.js";
+import { uiPreferences } from "../utils/ui-preferences.svelte.js";
+let {
+  fixApps = true
+} = $props();
+const isMobile = new IsMobile();
+const isDark = $derived(mode.current === "dark");
+function changeLocale(value) {
+  if (value && isLocale(value)) afterOverlaysSettle(() => setLocale(value));
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function checkNow() {
+  appUpdate.checkForUpdates();
+  const started = Date.now();
+  while (appUpdate.status !== "checking" && Date.now() - started < 2e3) await delay(40);
+  while (appUpdate.status === "checking" && Date.now() - started < 25e3) await delay(40);
+  const status = appUpdate.status;
+  if (status === "readyToApply") {
+    if (appUpdate.latestVersion && appUpdate.latestVersion === appUpdate.currentVersion) {
+      toast.info(t("update_none_found"));
+      return;
+    }
+    toast.info(
+      t("update_ready_title", {
+        from: appUpdate.currentVersion ?? "\u2014",
+        to: appUpdate.latestVersion ?? ""
+      }),
+      {
+        action: {
+          label: t("update_install_now"),
+          onClick: () => appUpdate.applyUpdate()
+        }
+      }
+    );
+  } else if (status === "available") {
+    toast.info(t("update_available"), {
+      action: {
+        label: t("update_download"),
+        onClick: () => appUpdate.startUpdate()
+      }
+    });
+  } else if (status === "upToDate") {
+    toast.info(t("update_none_found"));
+  } else if (status === "failed") {
+    toast.error(t("update_failed"), {
+      description: appUpdate.error ?? void 0,
+      action: {
+        label: t("update_retry"),
+        onClick: () => appUpdate.checkForUpdates()
+      }
+    });
+  } else if (status === "paused") {
+    toast.info(t("update_paused"), {
+      action: { label: t("update_resume"), onClick: () => appUpdate.startUpdate() }
+    });
+  } else if (status === "unavailable") {
+    toast.error(t("update_unavailable"));
+  }
+}
+</script>
+
+<PageHeading icon="fluent:options-24-filled">{t('preferences')}</PageHeading>
+
+<div class="flex min-w-0 flex-col gap-6">
+  <Card.Root class="@container/card w-full max-w-3xl">
+    <Card.Header>
+      <Card.Title>{t('interface')}</Card.Title>
+    </Card.Header>
+  <Card.Content class="space-y-6">
+    <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+      <Field.Content>
+        <Field.Label for="language">
+          <Icon icon="fluent:local-language-20-filled" />
+          {t('language')}
+        </Field.Label>
+        <Field.Description>
+          {t('languageDescription')}
+        </Field.Description>
+      </Field.Content>
+      <Select.Root
+        type="single"
+        value={getLocale()}
+        onValueChange={changeLocale}
+      >
+        <Select.Trigger>
+          <span data-slot="select-value">
+            <span class="font-bold">
+              {getLocale().toLocaleUpperCase()}
+            </span>
+            {getLocale() === "en" ? t('en') : t('ro')}
+          </span>
+        </Select.Trigger>
+        <Select.Content>
+          <Select.Item value="en">
+            <span class="font-bold">
+              EN
+            </span>{t('en')}
+          </Select.Item>
+          <Select.Item value="ro">
+            <span class="font-bold">
+              RO
+            </span>
+            {t('ro')}
+          </Select.Item>
+        </Select.Content>
+      </Select.Root>
+    </Field.Field>
+
+    <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+      <Field.Content>
+        <Field.Label for="theme" class="relative">
+          <span class="relative inline-flex shrink-0">
+            <Icon
+              icon="fluent:weather-sunny-24-filled"
+              class="size-5 scale-100 rotate-0 !transition-all dark:scale-0 dark:-rotate-90"
+            />
+            <Icon
+              icon="fluent:weather-moon-24-filled"
+              class="absolute inset-0 size-5 scale-0 rotate-90 !transition-all dark:scale-100 dark:rotate-0"
+            />
+          </span>
+          {t('theme')}
+        </Field.Label>
+        <Field.Description>
+          {t('themeDescription')}
+        </Field.Description>
+      </Field.Content>
+      <Switch.Root
+        id="theme"
+        checked={isDark}
+        onCheckedChange={(v) => setMode(v ? 'dark' : 'light')}
+      />
+    </Field.Field>
+
+    <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+      <Field.Content>
+        <Field.Label for="helpNotes">
+          <Icon icon="fluent:question-circle-24-filled" />
+          {t('help_notes')}
+        </Field.Label>
+        <Field.Description>
+          {t('help_notes_description')}
+        </Field.Description>
+      </Field.Content>
+      <Switch.Root
+        id="helpNotes"
+        checked={uiPreferences.hideHelpBubbles}
+        onCheckedChange={(v) => uiPreferences.hideHelpBubbles = v}
+      />
+    </Field.Field>
+    </Card.Content>
+  </Card.Root>
+
+  {#if fixApps && deviceStore.hasNativeBridge}
+    <Card.Root class="@container/card w-full max-w-3xl">
+      <Card.Header>
+        <Card.Title>{t('updates')}</Card.Title>
+      </Card.Header>
+      <Card.Content class="space-y-6">
+        <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+          <Field.Content>
+            <Field.Label for="autoUpdate">
+              <Icon icon="fluent:arrow-sync-24-filled" />
+              {t('auto_update')}
+            </Field.Label>
+            <Field.Description>
+              {t('auto_update_description')}
+            </Field.Description>
+          </Field.Content>
+          <Switch.Root
+            id="autoUpdate"
+            checked={appUpdate.autoUpdate}
+            onCheckedChange={(v) => appUpdate.setAutoUpdate(v)}
+          />
+        </Field.Field>
+
+        <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+          <Field.Content>
+            <Field.Label for="idealUpdateHour">
+              <Icon icon="fluent:clock-24-filled" />
+              {t('ideal_update_hour')}
+            </Field.Label>
+            <Field.Description>
+              {t('ideal_update_hour_description')}
+            </Field.Description>
+          </Field.Content>
+          <Select.Root
+            type="single"
+            value={String(appUpdate.idealUpdateHour).padStart(2, '0')}
+            onValueChange={(v) => v && appUpdate.setIdealUpdateHour(parseInt(v, 10))}
+          >
+            <Select.Trigger class="w-full max-w-56">
+              <span data-slot="select-value">
+                {String(appUpdate.idealUpdateHour).padStart(2, '0')}:00
+              </span>
+            </Select.Trigger>
+            <Select.Content class="max-h-64">
+              {#each Array.from({ length: 24 }, (_, i) => String(i).padStart(2, '0')) as hour}
+                <Select.Item value={hour}>
+                  {hour}:00
+                </Select.Item>
+              {/each}
+            </Select.Content>
+          </Select.Root>
+        </Field.Field>
+
+        <Field.Field orientation={isMobile.current ? "vertical" : "horizontal"}>
+          <Field.Content>
+            <Field.Label>
+              <Icon icon="fluent:arrow-clockwise-24-filled" />
+              {t('check_for_updates')}
+            </Field.Label>
+            <Field.Description>
+              {t('check_for_updates_description')}
+            </Field.Description>
+          </Field.Content>
+          <div class="flex w-full max-w-56 flex-col items-stretch gap-2">
+            {#if appUpdate.status === 'readyToApply'}
+              <Button onclick={() => appUpdate.applyUpdate()}>
+                {t('update_install_now')}
+              </Button>
+            {:else if appUpdate.status === 'available'}
+              <Button onclick={() => appUpdate.startUpdate()}>
+                {t('update_download')}
+              </Button>
+            {:else if appUpdate.status === 'downloading'}
+              <Button variant="secondary" onclick={() => appUpdate.pauseUpdate()}>
+                {t('update_pause')}
+              </Button>
+            {:else if appUpdate.status === 'paused'}
+              <Button onclick={() => appUpdate.startUpdate()}>
+                {t('update_resume')}
+              </Button>
+            {:else if appUpdate.status === 'failed'}
+              <Button onclick={() => appUpdate.checkForUpdates()}>
+                {t('update_retry')}
+              </Button>
+            {/if}
+            <Button
+              variant="secondary"
+              disabled={appUpdate.status === 'checking' || appUpdate.status === 'downloading' || appUpdate.status === 'verifying' || appUpdate.status === 'paused'}
+              onclick={() => void checkNow()}
+            >
+              {appUpdate.status === 'checking' ? t('update_checking') : t('check_for_updates')}
+            </Button>
+            {#if appUpdate.status === 'downloading' || appUpdate.status === 'paused'}
+              <div class="h-1.5 overflow-hidden rounded-full bg-muted">
+                <div class="h-full rounded-full bg-primary transition-all" style="width: {appUpdate.progress}%"></div>
+              </div>
+              <p class="text-muted-foreground text-center text-xs">
+                {appUpdate.status === 'paused' ? t('update_paused') : t('update_downloading')} ({appUpdate.progress}%)
+              </p>
+            {:else if appUpdate.status === 'verifying'}
+              <p class="text-muted-foreground text-center text-xs">{t('update_verifying')}</p>
+            {:else if appUpdate.status === 'failed' && appUpdate.error}
+              <p class="text-destructive text-center text-xs">{appUpdate.error}</p>
+            {/if}
+          </div>
+        </Field.Field>
+      </Card.Content>
+    </Card.Root>
+  {:else if fixApps}
+    <AppDownloadCard />
+  {/if}
+
+  {#if fixApps}
+    <div class="flex w-full max-w-3xl items-center justify-between px-1">
+      <a href="https://www.zexsoft.eu" target="_blank" rel="noopener noreferrer" class="flex">
+        <ZexsoftLogo class="h-7 opacity-10"></ZexsoftLogo>
+      </a>
+      <p class="text-md font-mono opacity-25">v{appUpdate.currentVersion ?? '—'}</p>
+    </div>
+  {/if}
+</div>

package/dist/pages/PreferencesPage.svelte.d.ts

@@ -0,0 +1,7 @@
+type $$ComponentProps = {
+    /** Shows the FIX Fiscal app updates or downloads and its version; a host app of its own turns it off. */
+    fixApps?: boolean;
+};
+declare const PreferencesPage: import("svelte").Component<$$ComponentProps, {}, "">;
+type PreferencesPage = ReturnType<typeof PreferencesPage>;
+export default PreferencesPage;

package/dist/utils/url-query-state.d.ts

@@ -9,7 +9,11 @@ export declare function readQueryCsv(url: URL, key: string): string[] | null;
 export declare function csvToSelected<T extends string>(allIds: T[], csv: string[] | null): Record<T, boolean> | null;
 /** Writes selected ids; omits the key when every option is selected (unfiltered). */
 export declare function writeQueryCsv(key: string, selectedIds: string[], allIds: string[]): void;
-/** Merges `patch` into the current URL query; `null`/empty deletes the key. Coalesces concurrent calls via microtask. */
+/**
+ * Merges `patch` into the current URL query; `null`/empty deletes the key. Coalesces concurrent calls into one write.
+ * A macrotask, not a microtask: a table mounted during SvelteKit's start-up (the session restored before the first
+ * render) would otherwise write before the router is initialized, which SvelteKit rejects.
+ */
 export declare function applyQuery(patch: Record<string, string | null>): void;
 /** Saved toolbar/list query for `orgId` on the current path, if this tenant was visited. */
 export declare function recallPageFilters(orgId: string | null | undefined): Record<string, string> | undefined;

package/dist/utils/url-query-state.js

@@ -30,13 +30,17 @@ export function writeQueryCsv(key, selectedIds, allIds) {
 let pendingPatch = {};
 let scheduled = false;
 let stagedParams = null;
-/** Merges `patch` into the current URL query; `null`/empty deletes the key. Coalesces concurrent calls via microtask. */
+/**
+ * Merges `patch` into the current URL query; `null`/empty deletes the key. Coalesces concurrent calls into one write.
+ * A macrotask, not a microtask: a table mounted during SvelteKit's start-up (the session restored before the first
+ * render) would otherwise write before the router is initialized, which SvelteKit rejects.
+ */
 export function applyQuery(patch) {
     Object.assign(pendingPatch, patch);
     if (scheduled)
         return;
     scheduled = true;
-    queueMicrotask(() => {
+    setTimeout(() => {
         scheduled = false;
         const toApply = pendingPatch;
         pendingPatch = {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zexsoft/fix-core",
-	"version": "1.14.15",
+	"version": "1.14.16-staging",
 	"description": "Official FIX Fiscal platform library for SvelteKit: the headless API client (auth and sessions, organizations, permissions, notifications, i18n) and the FIX Svelte components, from simple UI to drop-in pages.",
 	"author": "Zexsoft®",
 	"license": "MIT",