@seedgrid/fe-core 0.2.0

package/dist/i18n.d.ts

@@ -0,0 +1,4 @@
+export type SeedGridLocale = "pt-BR";
+export type SeedGridMessages = Record<string, Record<string, string>>;
+export declare function mergeMessages(target: SeedGridMessages, add: SeedGridMessages): SeedGridMessages;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAM/F"}

package/dist/i18n.js

@@ -0,0 +1,7 @@
+export function mergeMessages(target, add) {
+    const out = { ...target };
+    for (const ns of Object.keys(add)) {
+        out[ns] = { ...(out[ns] ?? {}), ...(add[ns] ?? {}) };
+    }
+    return out;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./module";
+export * from "./registry";
+export * from "./i18n";
+export * from "./persistence";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./module";
+export * from "./registry";
+export * from "./i18n";
+export * from "./persistence";

package/dist/module.d.ts

@@ -0,0 +1,34 @@
+import type React from "react";
+export type SeedGridModuleId = string;
+export type SeedGridProvider = React.ComponentType<{
+    children: React.ReactNode;
+}>;
+export type SeedGridNavItem = {
+    id: string;
+    labelKey: string;
+    href: string;
+    icon?: string;
+    requiresAuth?: boolean;
+    order?: number;
+};
+export type SeedGridRoute = {
+    id: string;
+    path: string;
+    requiresAuth?: boolean;
+};
+export type SeedGridI18nBundle = {
+    namespace: string;
+    resources: Record<string, string>;
+    distPath?: string;
+};
+export type SeedGridModuleManifest = {
+    id: SeedGridModuleId;
+    name: string;
+    version: string;
+    i18n?: {
+        defaultLocale: "pt-BR";
+        bundles: SeedGridI18nBundle[];
+    };
+    register: (registry: import("./registry").SeedGridRegistry) => void;
+};
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,aAAa,EAAE,OAAO,CAAC;QACvB,OAAO,EAAE,kBAAkB,EAAE,CAAC;KAC/B,CAAC;IACF,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,YAAY,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACrE,CAAC"}

package/dist/module.js

@@ -0,0 +1 @@
+export {};

package/dist/persistence.d.ts

@@ -0,0 +1,44 @@
+export type NamespaceProvider = {
+    getNamespace: () => string | null;
+};
+export type PersistenceStrategy = {
+    load: (key: string) => unknown | Promise<unknown>;
+    save: (key: string, state: unknown) => void | Promise<void>;
+    clear: (key: string) => void | Promise<void>;
+};
+export type SgPersistenceRecordDTO = {
+    protocolVersion: 1;
+    key: string;
+    scope: string;
+    stateVersion: number;
+    updatedAt: string;
+    state: unknown;
+};
+export type SgPersistenceMode = "strict" | "fallback" | "mirror";
+export type SgPersistenceConfig = {
+    scope: string;
+    mode: SgPersistenceMode;
+    stateVersion: number;
+};
+export type SgEnvironmentValue = {
+    namespaceProvider: NamespaceProvider;
+    persistenceStrategy: PersistenceStrategy;
+    persistence: SgPersistenceConfig;
+};
+export type SgEnvironment = SgEnvironmentValue;
+export declare function buildSgPersistenceKey(baseKey: string, namespace?: string | null, scope?: string | null): string | null;
+export declare function createLocalStorageStrategy(options?: {
+    prefix?: string;
+}): PersistenceStrategy;
+export declare function createApiPersistenceStrategy(args: {
+    baseUrl: string;
+    fetcher?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    scope: string;
+    stateVersion: number;
+}): PersistenceStrategy;
+export declare function createCompositePersistenceStrategy(args: {
+    mode: SgPersistenceMode;
+    primary: PersistenceStrategy;
+    secondary: PersistenceStrategy;
+}): PersistenceStrategy;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,eAAe,EAAE,CAAC,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,WAAW,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAI/C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,iBAMtG;AAED,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA4B7F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,mBAAmB,CAuCtB;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,mBAAmB,CA4DtB"}

package/dist/persistence.js

@@ -0,0 +1,152 @@
+/* ─── Persistence types ─── */
+/* ─── Pure functions ─── */
+export function buildSgPersistenceKey(baseKey, namespace, scope) {
+    const resolved = namespace ?? "";
+    if (!resolved)
+        return null;
+    const resolvedScope = (scope ?? "").trim();
+    if (!resolvedScope)
+        return `sg:${resolved}:${baseKey}`;
+    return `sg:${resolved}:${resolvedScope}:${baseKey}`;
+}
+export function createLocalStorageStrategy(options) {
+    const prefix = options?.prefix ?? "";
+    const full = (key) => (prefix ? `${prefix}${key}` : key);
+    return {
+        load: (key) => {
+            try {
+                const raw = window.localStorage.getItem(full(key));
+                if (raw == null)
+                    return null;
+                return JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+        },
+        save: (key, state) => {
+            try {
+                window.localStorage.setItem(full(key), JSON.stringify(state));
+            }
+            catch {
+                // ignore
+            }
+        },
+        clear: (key) => {
+            try {
+                window.localStorage.removeItem(full(key));
+            }
+            catch {
+                // ignore
+            }
+        }
+    };
+}
+export function createApiPersistenceStrategy(args) {
+    const fetcher = args.fetcher ?? fetch;
+    const base = args.baseUrl.replace(/\/$/, "");
+    const version = args.stateVersion;
+    const scope = args.scope;
+    return {
+        load: async (key) => {
+            const res = await fetcher(`${base}/sg/persistence?key=${encodeURIComponent(key)}`, {
+                method: "GET"
+            });
+            if (!res.ok)
+                throw new Error(`SG persistence load failed (${res.status})`);
+            const data = (await res.json());
+            if (!data?.found || !data.record)
+                return null;
+            return data.record.state;
+        },
+        save: async (key, state) => {
+            const record = {
+                protocolVersion: 1,
+                key,
+                scope,
+                stateVersion: version,
+                updatedAt: new Date().toISOString(),
+                state
+            };
+            const res = await fetcher(`${base}/sg/persistence`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ record })
+            });
+            if (!res.ok)
+                throw new Error(`SG persistence save failed (${res.status})`);
+        },
+        clear: async (key) => {
+            const res = await fetcher(`${base}/sg/persistence?key=${encodeURIComponent(key)}`, {
+                method: "DELETE"
+            });
+            if (!res.ok)
+                throw new Error(`SG persistence clear failed (${res.status})`);
+        }
+    };
+}
+export function createCompositePersistenceStrategy(args) {
+    const { mode, primary, secondary } = args;
+    return {
+        load: async (key) => {
+            if (mode === "strict") {
+                return await primary.load(key);
+            }
+            if (mode === "mirror") {
+                try {
+                    const remote = await primary.load(key);
+                    if (remote !== null && remote !== undefined)
+                        return remote;
+                }
+                catch {
+                    // ignore and fallback
+                }
+                return await secondary.load(key);
+            }
+            try {
+                return await primary.load(key);
+            }
+            catch {
+                return await secondary.load(key);
+            }
+        },
+        save: async (key, state) => {
+            if (mode === "strict") {
+                await primary.save(key, state);
+                return;
+            }
+            if (mode === "mirror") {
+                await Promise.allSettled([
+                    Promise.resolve(primary.save(key, state)),
+                    Promise.resolve(secondary.save(key, state))
+                ]);
+                return;
+            }
+            try {
+                await primary.save(key, state);
+            }
+            catch {
+                await secondary.save(key, state);
+            }
+        },
+        clear: async (key) => {
+            if (mode === "strict") {
+                await primary.clear(key);
+                return;
+            }
+            if (mode === "mirror") {
+                await Promise.allSettled([
+                    Promise.resolve(primary.clear(key)),
+                    Promise.resolve(secondary.clear(key))
+                ]);
+                return;
+            }
+            try {
+                await primary.clear(key);
+            }
+            catch {
+                await secondary.clear(key);
+            }
+        }
+    };
+}

package/dist/registry.d.ts

@@ -0,0 +1,13 @@
+import type { SeedGridNavItem, SeedGridProvider, SeedGridRoute } from "./module";
+export declare class SeedGridRegistry {
+    private providers;
+    private navItems;
+    private routes;
+    addProvider(provider: SeedGridProvider): void;
+    addNavItem(item: SeedGridNavItem): void;
+    addRoute(route: SeedGridRoute): void;
+    getProviders(): SeedGridProvider[];
+    getNavItems(): SeedGridNavItem[];
+    getRoutes(): SeedGridRoute[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAAuB;IAErC,WAAW,CAAC,QAAQ,EAAE,gBAAgB;IAItC,UAAU,CAAC,IAAI,EAAE,eAAe;IAIhC,QAAQ,CAAC,KAAK,EAAE,aAAa;IAI7B,YAAY;IAIZ,WAAW;IAIX,SAAS;CAGV"}

package/dist/registry.js

@@ -0,0 +1,23 @@
+export class SeedGridRegistry {
+    providers = [];
+    navItems = [];
+    routes = [];
+    addProvider(provider) {
+        this.providers.push(provider);
+    }
+    addNavItem(item) {
+        this.navItems.push(item);
+    }
+    addRoute(route) {
+        this.routes.push(route);
+    }
+    getProviders() {
+        return [...this.providers];
+    }
+    getNavItems() {
+        return [...this.navItems].sort((a, b) => (a.order ?? 999) - (b.order ?? 999));
+    }
+    getRoutes() {
+        return [...this.routes];
+    }
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@seedgrid/fe-core",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0"
+  }
+}