@zoiq.io/dev-kit 0.1.0 → 0.1.2

package/dist/server.mjs

@@ -0,0 +1,20 @@
+// src/server.ts
+async function getProjectSettingsServer(projectKey, baseUrl) {
+  if (!projectKey?.trim() || !baseUrl?.trim()) return null;
+  const url = `${baseUrl.replace(/\/$/, "")}/api/zoiq/project/${encodeURIComponent(projectKey)}`;
+  try {
+    const res = await fetch(url, {
+      cache: "no-store",
+      headers: { Accept: "application/json" }
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data;
+  } catch {
+    return null;
+  }
+}
+
+export { getProjectSettingsServer };
+//# sourceMappingURL=server.mjs.map
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":";AAoBA,eAAsB,wBAAA,CACpB,YACA,OAAA,EACiC;AACjC,EAAA,IAAI,CAAC,YAAY,IAAA,EAAK,IAAK,CAAC,OAAA,EAAS,IAAA,IAAQ,OAAO,IAAA;AAEpD,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,OAAA,CAAQ,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAC,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,UAAU,CAAC,CAAA,CAAA;AAE5F,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC3B,KAAA,EAAO,UAAA;AAAA,MACP,OAAA,EAAS,EAAE,MAAA,EAAQ,kBAAA;AAAmB,KACvC,CAAA;AACD,IAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAO,IAAA;AACpB,IAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,EAAK;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF","file":"server.mjs","sourcesContent":["/**\n * Server-only: load project settings for ZOIQ (styleGuide, branding, definedColors, etc.).\n * Use in Next.js Server Components, layout, or Route Handlers. Requires baseUrl (no window on server).\n *\n * @example\n * // In a Server Component or layout\n * import { getProjectSettingsServer } from '@zoiq.io/dev-kit/server'\n * const baseUrl = process.env.NEXT_PUBLIC_ZOIQ_API_BASE_URL || 'https://your-portal.com'\n * const settings = await getProjectSettingsServer(projectKey, baseUrl)\n */\nimport type { ProjectSettings } from './context/types'\n\n/**\n * Load project settings on the server by fetching from the ZOIQ project config API.\n * Use in Next.js Server Components, getServerSideProps, or Route Handlers.\n *\n * @param projectKey - Project ID or public API key\n * @param baseUrl - Base URL of the portal (e.g. https://your-portal.com). No trailing slash.\n * @returns ProjectSettings or null if not found / request failed\n */\nexport async function getProjectSettingsServer(\n  projectKey: string,\n  baseUrl: string,\n): Promise<ProjectSettings | null> {\n  if (!projectKey?.trim() || !baseUrl?.trim()) return null\n\n  const url = `${baseUrl.replace(/\\/$/, '')}/api/zoiq/project/${encodeURIComponent(projectKey)}`\n\n  try {\n    const res = await fetch(url, {\n      cache: 'no-store',\n      headers: { Accept: 'application/json' },\n    })\n    if (!res.ok) return null\n    const data = (await res.json()) as ProjectSettings\n    return data\n  } catch {\n    return null\n  }\n}\n\nexport type { ProjectSettings } from './context/types'\n"]}

package/dist/types-DaSMeWe9.d.mts

@@ -0,0 +1,151 @@
+type ProjectStyleGuide = {
+    __typename: "ProjectStyleGuide";
+    background?: string | null;
+    foreground?: string | null;
+    card?: string | null;
+    cardForeground?: string | null;
+    popover?: string | null;
+    popoverForeground?: string | null;
+    primary?: string | null;
+    primaryForeground?: string | null;
+    secondary?: string | null;
+    secondaryForeground?: string | null;
+    muted?: string | null;
+    mutedForeground?: string | null;
+    accent?: string | null;
+    accentForeground?: string | null;
+    destructive?: string | null;
+    destructiveForeground?: string | null;
+    border?: string | null;
+    input?: string | null;
+    ring?: string | null;
+    chart1?: string | null;
+    chart2?: string | null;
+    chart3?: string | null;
+    chart4?: string | null;
+    chart5?: string | null;
+    sidebar?: string | null;
+    sidebarForeground?: string | null;
+    sidebarPrimary?: string | null;
+    sidebarPrimaryForeground?: string | null;
+    sidebarAccent?: string | null;
+    sidebarAccentForeground?: string | null;
+    sidebarBorder?: string | null;
+    sidebarBorderDescription?: string | null;
+    sidebarRing?: string | null;
+    fontPrimary?: StyleGuideFont | null;
+    fontSecondary?: StyleGuideFont | null;
+    fontTertiary?: StyleGuideFont | null;
+    radius?: string | null;
+    trackingNormal?: string | null;
+    spacing?: string | null;
+    shadow2xs?: string | null;
+    shadowXs?: string | null;
+    shadowSm?: string | null;
+    shadow?: string | null;
+    shadowMd?: string | null;
+    shadowLg?: string | null;
+    shadowXl?: string | null;
+    shadow2xl?: string | null;
+    variables?: Array<Variable | null> | null;
+};
+type StyleGuideFont = {
+    __typename: "StyleGuideFont";
+    url: string;
+    name: string;
+};
+type Variable = {
+    __typename: "Variable";
+    key: string;
+    default?: boolean | null;
+    value: string;
+};
+
+/**
+ * Project theme/settings shape returned by the config API and consumed by ZOIQProvider.
+ *
+ */
+
+interface ProjectSettings {
+    styleGuide?: ProjectStyleGuide;
+    branding?: {
+        navbarLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        footerLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        loaderLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        faviconLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        authImage?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        customLogos?: Array<{
+            name: string;
+            description?: string | null;
+            fileID?: string | null;
+            link?: string | null;
+        } | null> | null;
+        primaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+        secondaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+        tertiaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+    } | null;
+    definedColors?: Array<{
+        id: string;
+        name: string;
+        value: string;
+    } | null> | null;
+    clientDefinedColors?: Array<{
+        name: string;
+        description?: string | null;
+        definedColor?: {
+            name: string;
+            value: string;
+        } | null;
+    } | null> | null;
+    navbarSettings?: {
+        isSticky?: boolean | null;
+        fontSize?: string | null;
+        alignment?: string | null;
+        logoSize?: string | null;
+        navbarType?: string | null;
+        gutters?: string | null;
+        subCategoryAnimation?: string | null;
+    } | null;
+    /** API key for fetching project/DynamoDB data from the API (stored in project dynamo as zoiqApiKey). */
+    apiKey?: string | null;
+}
+/**
+ * Section flag: enabled/disabled per section ID.
+ */
+interface SectionFlag {
+    id: string;
+    enabled: boolean;
+}
+/**
+ * Response shape for section flags API.
+ */
+interface SectionFlagsData {
+    enabledIds: string[];
+    disabledIds: string[];
+}
+
+export type { ProjectSettings as P, SectionFlag as S, SectionFlagsData as a };

package/dist/types-DaSMeWe9.d.ts

@@ -0,0 +1,151 @@
+type ProjectStyleGuide = {
+    __typename: "ProjectStyleGuide";
+    background?: string | null;
+    foreground?: string | null;
+    card?: string | null;
+    cardForeground?: string | null;
+    popover?: string | null;
+    popoverForeground?: string | null;
+    primary?: string | null;
+    primaryForeground?: string | null;
+    secondary?: string | null;
+    secondaryForeground?: string | null;
+    muted?: string | null;
+    mutedForeground?: string | null;
+    accent?: string | null;
+    accentForeground?: string | null;
+    destructive?: string | null;
+    destructiveForeground?: string | null;
+    border?: string | null;
+    input?: string | null;
+    ring?: string | null;
+    chart1?: string | null;
+    chart2?: string | null;
+    chart3?: string | null;
+    chart4?: string | null;
+    chart5?: string | null;
+    sidebar?: string | null;
+    sidebarForeground?: string | null;
+    sidebarPrimary?: string | null;
+    sidebarPrimaryForeground?: string | null;
+    sidebarAccent?: string | null;
+    sidebarAccentForeground?: string | null;
+    sidebarBorder?: string | null;
+    sidebarBorderDescription?: string | null;
+    sidebarRing?: string | null;
+    fontPrimary?: StyleGuideFont | null;
+    fontSecondary?: StyleGuideFont | null;
+    fontTertiary?: StyleGuideFont | null;
+    radius?: string | null;
+    trackingNormal?: string | null;
+    spacing?: string | null;
+    shadow2xs?: string | null;
+    shadowXs?: string | null;
+    shadowSm?: string | null;
+    shadow?: string | null;
+    shadowMd?: string | null;
+    shadowLg?: string | null;
+    shadowXl?: string | null;
+    shadow2xl?: string | null;
+    variables?: Array<Variable | null> | null;
+};
+type StyleGuideFont = {
+    __typename: "StyleGuideFont";
+    url: string;
+    name: string;
+};
+type Variable = {
+    __typename: "Variable";
+    key: string;
+    default?: boolean | null;
+    value: string;
+};
+
+/**
+ * Project theme/settings shape returned by the config API and consumed by ZOIQProvider.
+ *
+ */
+
+interface ProjectSettings {
+    styleGuide?: ProjectStyleGuide;
+    branding?: {
+        navbarLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        footerLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        loaderLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        faviconLogo?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        authImage?: {
+            fileID?: string | null;
+            link?: string | null;
+        } | null;
+        customLogos?: Array<{
+            name: string;
+            description?: string | null;
+            fileID?: string | null;
+            link?: string | null;
+        } | null> | null;
+        primaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+        secondaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+        tertiaryFont?: {
+            name?: string | null;
+            link?: string | null;
+        } | null;
+    } | null;
+    definedColors?: Array<{
+        id: string;
+        name: string;
+        value: string;
+    } | null> | null;
+    clientDefinedColors?: Array<{
+        name: string;
+        description?: string | null;
+        definedColor?: {
+            name: string;
+            value: string;
+        } | null;
+    } | null> | null;
+    navbarSettings?: {
+        isSticky?: boolean | null;
+        fontSize?: string | null;
+        alignment?: string | null;
+        logoSize?: string | null;
+        navbarType?: string | null;
+        gutters?: string | null;
+        subCategoryAnimation?: string | null;
+    } | null;
+    /** API key for fetching project/DynamoDB data from the API (stored in project dynamo as zoiqApiKey). */
+    apiKey?: string | null;
+}
+/**
+ * Section flag: enabled/disabled per section ID.
+ */
+interface SectionFlag {
+    id: string;
+    enabled: boolean;
+}
+/**
+ * Response shape for section flags API.
+ */
+interface SectionFlagsData {
+    enabledIds: string[];
+    disabledIds: string[];
+}
+
+export type { ProjectSettings as P, SectionFlag as S, SectionFlagsData as a };

package/dist/useZOIQEntity-CfY8Ag40.d.ts

@@ -0,0 +1,46 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { P as ProjectSettings } from './types-DaSMeWe9.js';
+
+interface ZOIQProviderProps {
+    /** Project key (e.g. project ID or public API key) to fetch theme and config */
+    projectKey: string;
+    /** Base URL for the project config API (e.g. https://your-portal.com/api/zoiq) */
+    /** Optional custom fetcher; if provided, apiBaseUrl is ignored for config fetch */
+    children: React.ReactNode;
+}
+interface ZOIQContextValue {
+    projectKey: string;
+    apiBaseUrl?: string;
+    settings: ProjectSettings | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    branding: ProjectSettings['branding'] | null;
+}
+declare function ZOIQProvider({ projectKey, children }: ZOIQProviderProps): react_jsx_runtime.JSX.Element;
+declare function useZOIQContext(): ZOIQContextValue | null;
+declare function useZOIQBranding(): ZOIQContextValue['branding'] | null;
+declare function useStyleGuide(): ProjectSettings['styleGuide'] | null;
+
+interface UseZOIQEntityOptions {
+    id?: string;
+    query?: Record<string, string>;
+}
+interface UseZOIQEntityResult<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetches custom entity data for the current project.
+ * Must be used within ZOIQProvider.
+ *
+ * For entities with REFERENCE fields (e.g. events with a partner field pointing to partners),
+ * the API expands the field value so the id is replaced with the full referenced record:
+ * e.g. events → { id, partner: { id, name, ... }, ...other event values }.
+ */
+declare function useZOIQEntity<T = unknown>(entity: string, options?: UseZOIQEntityOptions): UseZOIQEntityResult<T>;
+
+export { ZOIQProvider as Z, useZOIQEntity as a, useStyleGuide as b, useZOIQBranding as c, useZOIQContext as u };

package/dist/useZOIQEntity-Cv9WBq8W.d.mts

@@ -0,0 +1,46 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { P as ProjectSettings } from './types-DaSMeWe9.mjs';
+
+interface ZOIQProviderProps {
+    /** Project key (e.g. project ID or public API key) to fetch theme and config */
+    projectKey: string;
+    /** Base URL for the project config API (e.g. https://your-portal.com/api/zoiq) */
+    /** Optional custom fetcher; if provided, apiBaseUrl is ignored for config fetch */
+    children: React.ReactNode;
+}
+interface ZOIQContextValue {
+    projectKey: string;
+    apiBaseUrl?: string;
+    settings: ProjectSettings | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    branding: ProjectSettings['branding'] | null;
+}
+declare function ZOIQProvider({ projectKey, children }: ZOIQProviderProps): react_jsx_runtime.JSX.Element;
+declare function useZOIQContext(): ZOIQContextValue | null;
+declare function useZOIQBranding(): ZOIQContextValue['branding'] | null;
+declare function useStyleGuide(): ProjectSettings['styleGuide'] | null;
+
+interface UseZOIQEntityOptions {
+    id?: string;
+    query?: Record<string, string>;
+}
+interface UseZOIQEntityResult<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetches custom entity data for the current project.
+ * Must be used within ZOIQProvider.
+ *
+ * For entities with REFERENCE fields (e.g. events with a partner field pointing to partners),
+ * the API expands the field value so the id is replaced with the full referenced record:
+ * e.g. events → { id, partner: { id, name, ... }, ...other event values }.
+ */
+declare function useZOIQEntity<T = unknown>(entity: string, options?: UseZOIQEntityOptions): UseZOIQEntityResult<T>;
+
+export { ZOIQProvider as Z, useZOIQEntity as a, useStyleGuide as b, useZOIQBranding as c, useZOIQContext as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoiq.io/dev-kit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "description": "ZOIQ - React component library and framework with project-key-driven theme, hooks, and UI primitives",
   "main": "./dist/index.js",
@@ -11,6 +11,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
     }
   },
   "files": [
@@ -18,7 +28,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node scripts/add-use-client.js",
     "dev": "tsup --watch"
   },
   "peerDependencies": {
@@ -27,7 +37,8 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "tailwind-merge": "^3.2.0"
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.1.18"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",