@xforge-dev/forge-kit 0.17.0 → 0.18.0

package/dist/client.d.ts

@@ -12,3 +12,4 @@ export { ForgeLogo, type ForgeLogoProps } from './forge-logo.js';
 export { ForgeSupportButton, BUY_ME_A_COFFEE_URL, BUY_ME_A_COFFEE_BUTTON, FORGE_SPONSOR_TIERS, ForgeSupporterBadge, type ForgeSupporterTier, type ForgeSupportButtonProps, } from './support-button.js';
 export { ForgeIgnInput, FORGE_ACCENTED_LETTERS, FORGE_NO_AUTOFILL, type ForgeIgnInputProps, } from './ign-input.js';
 export { ForgeFooter, type ForgeFooterProps } from './forge-footer.js';
+export { ForgeJobsProvider } from './jobs-provider.js';

package/dist/client.js

@@ -13,3 +13,4 @@ export { ForgeLogo } from './forge-logo.js';
 export { ForgeSupportButton, BUY_ME_A_COFFEE_URL, BUY_ME_A_COFFEE_BUTTON, FORGE_SPONSOR_TIERS, ForgeSupporterBadge, } from './support-button.js';
 export { ForgeIgnInput, FORGE_ACCENTED_LETTERS, FORGE_NO_AUTOFILL, } from './ign-input.js';
 export { ForgeFooter } from './forge-footer.js';
+export { ForgeJobsProvider } from './jobs-provider.js';

package/dist/forge-header.js

@@ -62,7 +62,10 @@ function AccountPanel({ current, account, syncError, nav = [], accountDetails, g
 /** A nav group in the mobile panel: its name as a small heading, then its links, a section title before each run. */
 function PanelNavGroup({ group }) {
     const Icon = group.icon;
-    return (_jsxs("div", { role: "group", "aria-label": group.label, className: "pt-2", children: [_jsxs("p", { className: "flex items-center gap-2 px-2 pb-1 text-xs font-medium text-muted-foreground", children: [Icon && _jsx(Icon, { "aria-hidden": true, className: "h-3.5 w-3.5" }), group.label] }), group.sections.map((section, i) => (_jsxs("div", { className: "space-y-1", children: [section.title && section.items.length > 0 && (_jsx("div", { className: "px-2 pb-0.5 pt-1.5 pl-9 text-xs text-muted-foreground", children: section.title })), section.items.map(({ href, label, icon, active }) => (_jsx(ForgePanelItem, { icon: icon, label: label, href: href, active: active }, href)))] }, section.key ?? i)))] }));
+    return (_jsxs("div", { role: "group", "aria-label": group.label, className: "pt-2", children: [_jsxs("p", { className: "flex items-center gap-2 px-2 pb-1 text-xs font-medium text-muted-foreground", children: [Icon && _jsx(Icon, { "aria-hidden": true, className: "h-3.5 w-3.5" }), group.label] }), group.sections.map((section, i) => (_jsxs("div", { className: "space-y-1", children: [section.title && section.items.length > 0 && (
+                    // A text title sits over the links' labels; a rich one (an avatar and name) brings its own leading
+                    // media, so it lines up with their icons instead.
+                    _jsx("div", { className: `px-2 pb-0.5 pt-1.5 text-xs text-muted-foreground ${typeof section.title === 'string' ? 'pl-9' : ''}`, children: section.title })), section.items.map(({ href, label, icon, active }) => (_jsx(ForgePanelItem, { icon: icon, label: label, href: href, active: active }, href)))] }, section.key ?? i)))] }));
 }
 /** Discord's mark in `currentColor`; give it Discord's blurple (`text-[#5865F2]`) next to a Discord name. */
 export function DiscordIcon({ className }) {

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export { isForgeAuthConfigured } from './config.js';
 export * from './theme.js';
 export { FORGE_BRANDS, FORGE_CDN, type ForgeBrand, type ForgeBrandId } from './brand.js';
 export { HANDOFF_PATH, LEGACY_ORIGINS, LEGACY_ROOT_DOMAIN, decideLegacy, legacyReceiveHtml, legacySendHtml, type LegacyDecision } from './legacy.js';
+export * from './jobs.js';

package/dist/index.js

@@ -7,3 +7,4 @@ export { isForgeAuthConfigured } from './config.js';
 export * from './theme.js';
 export { FORGE_BRANDS, FORGE_CDN } from './brand.js';
 export { HANDOFF_PATH, LEGACY_ORIGINS, LEGACY_ROOT_DOMAIN, decideLegacy, legacyReceiveHtml, legacySendHtml } from './legacy.js';
+export * from './jobs.js';

package/dist/jobs-provider.d.ts

@@ -0,0 +1,7 @@
+import type { ReactElement, ReactNode } from 'react';
+import { type JobCatalog } from './jobs.js';
+/** Installs the server-fetched catalog before the children render, so client lookups agree with the server. */
+export declare function ForgeJobsProvider({ catalog, children }: {
+    catalog: JobCatalog;
+    children: ReactNode;
+}): ReactElement;

package/dist/jobs-provider.js

@@ -0,0 +1,9 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { getJobCatalog, setJobCatalog } from './jobs.js';
+/** Installs the server-fetched catalog before the children render, so client lookups agree with the server. */
+export function ForgeJobsProvider({ catalog, children }) {
+    if (catalog.updated !== getJobCatalog().updated)
+        setJobCatalog(catalog);
+    return _jsx(_Fragment, { children: children });
+}

package/dist/jobs-server.d.ts

@@ -0,0 +1,10 @@
+import { type JobCatalog } from './jobs.js';
+/**
+ * Fetches the shared job catalog (Next's fetch cache, one hour by default), validates it and installs it
+ * as the registry. Any failure leaves the current catalog in place and warns once per distinct error.
+ */
+export declare function refreshJobCatalog(opts?: {
+    url?: string;
+    revalidate?: number;
+    fetch?: typeof fetch;
+}): Promise<JobCatalog>;

package/dist/jobs-server.js

@@ -0,0 +1,25 @@
+import { getJobCatalog, parseJobCatalog, setJobCatalog, JOB_CATALOG_URL } from './jobs.js';
+const warned = new Set();
+/**
+ * Fetches the shared job catalog (Next's fetch cache, one hour by default), validates it and installs it
+ * as the registry. Any failure leaves the current catalog in place and warns once per distinct error.
+ */
+export async function refreshJobCatalog(opts = {}) {
+    const doFetch = opts.fetch ?? fetch;
+    try {
+        const res = await doFetch(opts.url ?? JOB_CATALOG_URL, { next: { revalidate: opts.revalidate ?? 3600 } });
+        if (!res.ok)
+            throw new Error(`job catalog: HTTP ${res.status}`);
+        const next = parseJobCatalog(await res.json());
+        setJobCatalog(next);
+        return next;
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        if (!warned.has(message)) {
+            warned.add(message);
+            console.warn(`[forge-kit] job catalog refresh failed: ${message}`);
+        }
+        return getJobCatalog();
+    }
+}

package/dist/jobs-snapshot.d.ts

@@ -0,0 +1,2 @@
+import type { JobCatalog } from './jobs.js';
+export declare const JOBS_SNAPSHOT: JobCatalog;