@gostack-framework/react 0.0.0-stage → 0.1.0

package/dist/styles.css

@@ -0,0 +1,347 @@
+:root {
+  --gs-sidebar-width: 240px;
+  --color-dashboard-primary: #036268;
+  --color-dashboard-background: #f4f6f6;
+  --color-dashboard-card: #fff;
+  --color-dashboard-foreground: #183132;
+  --color-dashboard-muted-foreground: #647777;
+  --color-dashboard-secondary: #e8eeee;
+  --color-dashboard-border: #dce5e4;
+  --color-dashboard-sidebar: #f0f5f4;
+  --color-dashboard-sidebar-foreground: #274b4c;
+  font-family: Inter, Arial, sans-serif;
+  color: var(--color-dashboard-foreground);
+  background: var(--color-dashboard-background);
+}
+.dark {
+  --color-dashboard-background: #0f1415;
+  --color-dashboard-card: #171d1e;
+  --color-dashboard-foreground: #e6eeee;
+  --color-dashboard-muted-foreground: #95a6a7;
+  --color-dashboard-secondary: #243032;
+  --color-dashboard-border: #2a3839;
+  --color-dashboard-sidebar: #111c1d;
+  --color-dashboard-sidebar-foreground: #c3d2d3;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+}
+button,
+input,
+select,
+textarea {
+  font: inherit;
+}
+button,
+a,
+input,
+textarea,
+select {
+  outline-offset: 3px;
+}
+a {
+  color: inherit;
+  text-decoration: none;
+}
+button {
+  cursor: pointer;
+}
+button:disabled {
+  cursor: default;
+  opacity: 0.55;
+}
+html[dir="rtl"] {
+  font-family: Cairo, Tahoma, Arial, sans-serif;
+}
+.gs-shell {
+  height: 100dvh;
+  display: flex;
+  flex-direction: column;
+  font-size: 12px;
+}
+.gs-topbar {
+  height: 44px;
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  padding: 0 16px;
+  border-bottom: 1px solid var(--color-dashboard-border);
+  background: var(--color-dashboard-card);
+}
+.gs-icon-button {
+  border: 0;
+  background: transparent;
+  color: inherit;
+  min-width: 30px;
+  min-height: 30px;
+  border-radius: 6px;
+}
+.gs-icon-button:hover {
+  background: var(--color-dashboard-secondary);
+}
+.gs-brand {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 14px;
+  font-weight: 700;
+}
+.gs-brand img {
+  width: 24px;
+  height: 24px;
+  object-fit: contain;
+}
+.gs-mark {
+  display: grid;
+  place-items: center;
+  width: 24px;
+  height: 24px;
+  border-radius: 7px;
+  background: var(--color-dashboard-primary);
+  color: white;
+}
+.gs-header-slot {
+  flex: 1;
+}
+.gs-body {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+}
+.gs-sidebar {
+  width: var(--gs-sidebar-width);
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  padding: 16px 12px;
+  background: var(--color-dashboard-sidebar);
+  color: var(--color-dashboard-sidebar-foreground);
+  border-inline-end: 1px solid var(--color-dashboard-border);
+}
+.gs-sidebar nav {
+  overflow: auto;
+}
+.gs-workspace-label {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 4px 6px 24px;
+}
+.gs-workspace-label small {
+  display: block;
+  color: var(--color-dashboard-muted-foreground);
+  margin-top: 4px;
+}
+.gs-workspace-avatar {
+  display: grid;
+  place-items: center;
+  width: 34px;
+  height: 34px;
+  background: var(--color-dashboard-primary);
+  color: #fff;
+  border-radius: 9px;
+  font-weight: 600;
+}
+.gs-nav-section {
+  margin-top: 20px;
+}
+.gs-nav-section h2 {
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--color-dashboard-muted-foreground);
+  margin: 0 10px 8px;
+}
+.gs-nav-link {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 9px 10px;
+  border-radius: 6px;
+  margin: 2px 0;
+}
+.gs-nav-link:hover,
+.gs-nav-link.active {
+  background: var(--color-dashboard-secondary);
+}
+.gs-nav-link.active {
+  color: var(--color-dashboard-primary);
+  font-weight: 600;
+}
+.dark .gs-nav-link.active {
+  color: #69cccc;
+}
+.gs-nav-dot {
+  width: 6px;
+  height: 6px;
+  border: 1px solid currentColor;
+  border-radius: 2px;
+}
+.gs-nav-children {
+  padding-inline-start: 15px;
+}
+.gs-sidebar-footer {
+  margin-top: auto;
+  padding: 20px 8px 0;
+  color: var(--color-dashboard-muted-foreground);
+  font-size: 10px;
+}
+.gs-main {
+  flex: 1;
+  min-width: 0;
+  overflow: auto;
+}
+.gs-breadcrumbs {
+  padding: 14px 24px;
+  border-bottom: 1px solid var(--color-dashboard-border);
+  color: var(--color-dashboard-muted-foreground);
+  background: var(--color-dashboard-card);
+}
+.gs-content {
+  padding: 24px;
+}
+.gs-welcome {
+  max-width: 1000px;
+  margin: 48px auto;
+}
+.gs-eyebrow {
+  font-size: 11px;
+  letter-spacing: 0.18em;
+  color: var(--color-dashboard-primary);
+  font-weight: 700;
+}
+.gs-welcome h1 {
+  font-size: 32px;
+  letter-spacing: -0.03em;
+  margin: 12px 0;
+}
+.gs-welcome p {
+  font-size: 14px;
+  color: var(--color-dashboard-muted-foreground);
+  line-height: 1.8;
+}
+.gs-modules {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 16px;
+  margin-top: 32px;
+}
+.gs-module-card {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  border: 1px solid var(--color-dashboard-border);
+  padding: 24px;
+  border-radius: 10px;
+  background: var(--color-dashboard-card);
+}
+.gs-module-card:hover {
+  border-color: var(--color-dashboard-primary);
+}
+.gs-module-card strong {
+  font-size: 16px;
+}
+.gs-module-card span {
+  color: var(--color-dashboard-muted-foreground);
+}
+.gs-state {
+  padding: 64px 24px;
+  text-align: center;
+}
+.gs-site > header {
+  padding: 16px 24px;
+  display: flex;
+  justify-content: space-between;
+  border-bottom: 1px solid var(--color-dashboard-border);
+}
+.gs-site > main {
+  padding: 24px;
+}
+.gs-auth-layout {
+  min-height: 75vh;
+  display: grid;
+  place-items: center;
+}
+.gs-login {
+  width: min(100%, 380px);
+  display: grid;
+  gap: 20px;
+  padding: 32px;
+  border: 1px solid var(--color-dashboard-border);
+  background: var(--color-dashboard-card);
+  border-radius: 12px;
+}
+.gs-login h1 {
+  font-size: 24px;
+  margin: 0;
+}
+.gs-login label {
+  display: grid;
+  gap: 8px;
+}
+.gs-login input {
+  border: 1px solid var(--color-dashboard-border);
+  background: var(--color-dashboard-background);
+  color: inherit;
+  padding: 10px;
+  border-radius: 6px;
+  min-width: 0;
+}
+.gs-login button {
+  padding: 10px;
+  border: 0;
+  border-radius: 6px;
+  background: var(--color-dashboard-primary);
+  color: white;
+}
+.gs-backdrop {
+  display: none;
+}
+@media (min-width: 901px) {
+  .gs-topbar > .gs-icon-button:first-child {
+    display: none;
+  }
+}
+@media (max-width: 900px) {
+  .gs-sidebar {
+    display: none;
+  }
+  .gs-sidebar.is-open {
+    display: flex;
+    position: fixed;
+    inset-block: 44px 0;
+    inset-inline-start: 0;
+    z-index: 30;
+  }
+  .gs-backdrop {
+    display: block;
+    position: fixed;
+    inset: 44px 0 0;
+    background: #0006;
+    z-index: 20;
+    border: 0;
+  }
+  .gs-content {
+    padding: 16px;
+  }
+  .gs-breadcrumbs {
+    padding: 12px 16px;
+  }
+  .gs-welcome {
+    margin: 24px auto;
+  }
+  .gs-welcome h1 {
+    font-size: 27px;
+  }
+  .gs-topbar {
+    gap: 8px;
+    padding: 0 10px;
+  }
+  .gs-modules {
+    grid-template-columns: 1fr;
+  }
+}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+import type { ComponentType, ReactNode } from "react";
+import type { i18n } from "i18next";
+import type { QueryClient } from "@tanstack/react-query";
+import type { AuthAdapter, AuthSession } from "./auth";
+import type { HttpClient } from "./api";
+import type { LineFlowNetwork } from "./line-flow/types.js";
+export interface AccessRule {
+    requiresAuth?: boolean;
+    roles?: string[];
+    permissions?: string[];
+    requireAllPermissions?: boolean;
+}
+export interface RouteConfig extends AccessRule {
+    path?: string;
+    index?: boolean;
+    lazy?: () => Promise<{
+        default: ComponentType;
+    }>;
+    element?: ReactNode;
+    children?: RouteConfig[];
+    errorElement?: ReactNode;
+    meta?: {
+        title?: string;
+        titleKey?: string;
+        requiresAuth?: boolean;
+    };
+    handle?: Record<string, unknown>;
+}
+export interface NavItem extends AccessRule {
+    key: string;
+    label: string;
+    labelKey?: string;
+    href: string;
+    icon?: ComponentType<{
+        size?: number;
+        className?: string;
+    }>;
+    order?: number;
+    children?: NavItem[];
+}
+export interface ModuleDefinition extends AccessRule {
+    kind: "module";
+    id: string;
+    basePath: string;
+    layout: string;
+    label: string;
+    labelKey?: string;
+    order?: number;
+    enabled?: boolean;
+    layoutComponent?: ComponentType<LayoutProps>;
+}
+export interface FeatureDefinition extends AccessRule {
+    kind: "feature";
+    id: string;
+    basePath: string;
+    routes: RouteConfig[];
+    nav?: NavItem | NavItem[];
+    paths?: Record<string, string | ((...args: never[]) => string)>;
+    enabled?: boolean;
+    layout?: string;
+}
+export declare const defineModule: (value: Omit<ModuleDefinition, "kind">) => ModuleDefinition;
+export declare const defineFeature: (value: Omit<FeatureDefinition, "kind">) => FeatureDefinition;
+export interface Manifest {
+    definitions: {
+        file: string;
+        definition: ModuleDefinition | FeatureDefinition;
+    }[];
+    locales: {
+        file: string;
+        data: Record<string, unknown>;
+    }[];
+}
+export interface RegisteredFeature extends FeatureDefinition {
+    module: ModuleDefinition;
+    ancestors: ModuleDefinition[];
+    qualifiedId: string;
+    namespace: string;
+    source: string;
+}
+export interface Registry {
+    modules: ModuleDefinition[];
+    features: RegisteredFeature[];
+    resources: Record<string, Record<string, Record<string, unknown>>>;
+}
+export interface LayoutProps {
+    children?: ReactNode;
+}
+export interface GoStackSlots {
+    header?: ReactNode;
+    sidebarFooter?: ReactNode;
+    login?: ComponentType;
+    loading?: ComponentType;
+    unauthorized?: ComponentType;
+    notFound?: ComponentType;
+    error?: ComponentType<{
+        error: Error;
+        reset: () => void;
+    }>;
+}
+export interface AppConfig {
+    name: string;
+    id?: string;
+    logo?: string;
+    defaultLanguage?: string;
+    languages?: string[];
+    defaultTheme?: "light" | "dark" | "system";
+    theme?: Record<string, string>;
+    layouts: Record<string, ComponentType<LayoutProps>>;
+    slots?: GoStackSlots;
+    auth?: {
+        adapter: AuthAdapter;
+        loginPath?: string;
+        homePath?: string;
+    } | false;
+    api?: HttpClient;
+    queryClient?: QueryClient;
+    i18n?: i18n;
+    lineFlow?: LineFlowNetwork;
+    providers?: ComponentType<{
+        children: ReactNode;
+    }>;
+    onError?: (error: Error, context: string) => void;
+}
+export declare const defineApp: (config: AppConfig) => AppConfig;
+export declare function canAccess(rule: AccessRule, session: AuthSession | null): boolean;

package/dist/types.js

@@ -0,0 +1,19 @@
+export const defineModule = (value) => ({ ...value, kind: "module" });
+export const defineFeature = (value) => ({ ...value, kind: "feature" });
+export const defineApp = (config) => config;
+export function canAccess(rule, session) {
+    const protectedRule = rule.requiresAuth || !!rule.roles?.length || !!rule.permissions?.length;
+    if (protectedRule && !session)
+        return false;
+    if (rule.roles?.length &&
+        !rule.roles.some((role) => session?.roles.includes(role)))
+        return false;
+    if (rule.permissions?.length) {
+        const test = (permission) => !!session?.permissions.includes(permission);
+        return rule.requireAllPermissions
+            ? rule.permissions.every(test)
+            : rule.permissions.some(test);
+    }
+    return true;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqDA,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAqC,EACnB,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAsC,EACnB,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAoDxD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAiB,EAAa,EAAE,CAAC,MAAM,CAAC;AAClE,MAAM,UAAU,SAAS,CACvB,IAAgB,EAChB,OAA2B;IAE3B,MAAM,aAAa,GACjB,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC1E,IAAI,aAAa,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC5C,IACE,IAAI,CAAC,KAAK,EAAE,MAAM;QAClB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEzD,OAAO,KAAK,CAAC;IACf,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,UAAkB,EAAE,EAAE,CAClC,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,qBAAqB;YAC/B,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAC9B,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/conditionCompiler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Filter Condition Builder Engine
+ * Supports Open/Closed Principle: extensible filter operators
+ */
+export type FilterOperator = "=" | "!=" | "like" | "in" | "gt" | "lt" | "between";
+export interface FilterCondition {
+    field: string;
+    operator: FilterOperator;
+    value: string | number | boolean | (string | number)[];
+}
+export declare function compileFilterCondition(condition: FilterCondition): string;

package/dist/utils/conditionCompiler.js

@@ -0,0 +1,18 @@
+/**
+ * Filter Condition Builder Engine
+ * Supports Open/Closed Principle: extensible filter operators
+ */
+export function compileFilterCondition(condition) {
+    const { field, operator, value } = condition;
+    if (value === null || value === undefined || value === "") {
+        return "";
+    }
+    if (operator === "in" && Array.isArray(value)) {
+        return `${field}[operator]=in&${field}[value]=${value.map(encodeURIComponent).join(",")}`;
+    }
+    if (operator === "between" && Array.isArray(value) && value.length === 2) {
+        return `${field}[operator]=between&${field}[from]=${encodeURIComponent(value[0])}&${field}[to]=${encodeURIComponent(value[1])}`;
+    }
+    return `${field}[operator]=${operator}&${field}[value]=${encodeURIComponent(String(value))}`;
+}
+//# sourceMappingURL=conditionCompiler.js.map

package/dist/utils/conditionCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionCompiler.js","sourceRoot":"","sources":["../../src/utils/conditionCompiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,UAAU,sBAAsB,CAAC,SAA0B;IAC/D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAE7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,KAAK,iBAAiB,KAAK,WAAW,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,GAAG,KAAK,sBAAsB,KAAK,UAAU,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClI,CAAC;IAED,OAAO,GAAG,KAAK,cAAc,QAAQ,IAAI,KAAK,WAAW,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AAC/F,CAAC"}

package/dist/utils/fileUtils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * File utility functions for downloading and handling files
+ */
+import { AttachmentFile } from "../shared-types";
+/**
+ * Downloads a single file from a URL
+ * Uses fetch to get the blob and creates a temporary anchor element
+ */
+export declare function downloadFile(file: AttachmentFile): Promise<void>;
+/**
+ * Downloads multiple files sequentially with a small delay between each
+ * to prevent browser blocking
+ */
+export declare function downloadFiles(files: AttachmentFile[], delayMs?: number): Promise<{
+    success: number;
+    failed: number;
+}>;
+/**
+ * Formats file size to human readable format
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Gets file extension from filename
+ */
+export declare function getFileExtension(fileName: string): string;
+/**
+ * Gets icon type based on file type/extension
+ */
+export declare function getFileIconType(fileType: string): "pdf" | "image" | "document" | "other";
+/**
+ * Export generic array data to a CSV file
+ */
+export declare function exportToCSV<T>(data: T[], columns: {
+    header: string;
+    accessor: keyof T | ((row: T) => any);
+}[], filename?: string): void;
+/**
+ * Export generic array data to an Excel (.xlsx) file
+ */
+export declare function exportToExcel<T>(data: T[], columns: {
+    header: string;
+    accessor: keyof T | ((row: T) => any);
+}[], filename?: string): Promise<void>;
+/**
+ * Opens a native print dialog with a cleanly formatted HTML table of the data
+ */
+export declare function exportToPrint<T>(data: T[], columns: {
+    header: string;
+    accessor: keyof T | ((row: T) => any);
+}[], title?: string): void;