southpaw 0.2.7

package/modules/store.ts

@@ -0,0 +1,37 @@
+type StoreParams<
+  STATE extends Record<string, unknown>,
+  ACTIONS extends Record<
+    string,
+    (this: { state: STATE }, ...args: unknown[]) => Promise<void>
+  >,
+> = {
+  state: STATE;
+  actions: ACTIONS;
+};
+
+type ReturnType<
+  STATE extends Record<string, unknown>,
+  ACTIONS extends Record<string, (...args: unknown[]) => Promise<void>>,
+> = {
+  state: STATE;
+  actions: {
+    [ACTION_NAME in keyof ACTIONS]: OmitThisParameter<ACTIONS[ACTION_NAME]>;
+  };
+};
+
+export const create_store = <
+  STATE extends Record<string, unknown>,
+  ACTIONS extends Record<
+    string,
+    (this: { state: STATE }, ...args: unknown[]) => Promise<void>
+  >,
+>(
+  params: StoreParams<STATE, ACTIONS>
+) /*: ReturnType<STATE, ACTIONS> */ => {
+  const $$typeof = Symbol("southpaw.store");
+  const result = params as ReturnType<STATE, ACTIONS>;
+  return {
+    $$typeof,
+    ...result,
+  };
+};

package/modules/theme.ts

@@ -0,0 +1,105 @@
+import {
+  DefaultMantineColor,
+  MantineColorsTuple,
+  MantineTheme,
+} from "@mantine/core";
+import { GOOGLE_FONTS } from "../constants/fonts";
+
+type ThemeParams = Omit<
+  Partial<MantineTheme>,
+  "fontFamily" | "fontFamilyMonospace" | "colors"
+> & {
+  fontFamily: (typeof GOOGLE_FONTS)[number];
+  fontFamilyMonospace: (typeof GOOGLE_FONTS)[number];
+  colors: Partial<Record<DefaultMantineColor, string>>;
+};
+export const create_theme = (themeParams: ThemeParams) => {
+  const { colors: themeColors, ...other } = themeParams;
+  const colors = Object.entries(themeColors).reduce(
+    (acc, [color, value]) => {
+      if (value) {
+        acc[color] = generateColorTupleFromHex(value);
+      }
+      return acc;
+    },
+    {} as MantineTheme["colors"],
+  );
+  const theme: Partial<MantineTheme> = {
+    ...other,
+    colors,
+  };
+  return theme as MantineTheme;
+};
+
+function hexToHSL(hex: string): { h: number; s: number; l: number } {
+  hex = hex.replace(/^#/, "");
+
+  const bigint = parseInt(hex, 16);
+  const r = ((bigint >> 16) & 255) / 255;
+  const g = ((bigint >> 8) & 255) / 255;
+  const b = (bigint & 255) / 255;
+
+  const max = Math.max(r, g, b),
+    min = Math.min(r, g, b);
+  let h = 0,
+    s = 0;
+  const l = (max + min) / 2;
+
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    switch (max) {
+      case r:
+        h = (g - b) / d + (g < b ? 6 : 0);
+        break;
+      case g:
+        h = (b - r) / d + 2;
+        break;
+      case b:
+        h = (r - g) / d + 4;
+        break;
+    }
+    h *= 60;
+  }
+
+  return { h, s: s * 100, l: l * 100 };
+}
+
+// Convert HSL to HEX
+function hslToHex(h: number, s: number, l: number): string {
+  s /= 100;
+  l /= 100;
+
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+  const m = l - c / 2;
+
+  let r = 0,
+    g = 0,
+    b = 0;
+
+  if (h < 60) [r, g, b] = [c, x, 0];
+  else if (h < 120) [r, g, b] = [x, c, 0];
+  else if (h < 180) [r, g, b] = [0, c, x];
+  else if (h < 240) [r, g, b] = [0, x, c];
+  else if (h < 300) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+
+  const toHex = (n: number) =>
+    Math.round((n + m) * 255)
+      .toString(16)
+      .padStart(2, "0");
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+
+function generateColorTupleFromHex(baseHex: string) {
+  const { h, s, l } = hexToHSL(baseHex);
+  const shades: string[] = [];
+
+  for (let i = -1; i < 10; i++) {
+    const adjustedLightness = Math.min(95, Math.max(5, l + (i - 4.5) * -8)); // tweak light/darkness
+    shades.push(hslToHex(h, s, adjustedLightness));
+  }
+
+  return shades as unknown as MantineColorsTuple;
+}

package/modules/translations.ts

@@ -0,0 +1,15 @@
+type Translations<KEY extends string> = Record<
+  KEY,
+  (...args: any[]) => {
+    fr?: string;
+    ar?: string;
+    en?: string;
+  }
+>;
+export const create_translations = <KEY extends string>(
+  lang: "fr" | "ar" | "en",
+  translations: Translations<KEY>,
+) => {
+  const $$typeof = Symbol("southpaw.translations");
+  return { $$typeof, lang, translations };
+};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "southpaw",
+  "version": "0.2.7",
+  "description": "A behavior-driven Next.js framework",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "southpaw": "scripts/bin.js"
+  },
+  "files": [
+    "scripts/",
+    "modules/",
+    "ui/",
+    "hooks/",
+    "contexts/",
+    "themes/",
+    "types/",
+    "constants/",
+    "utils/",
+    "api/"
+  ],
+  "keywords": [
+    "nextjs",
+    "framework",
+    "react",
+    "behavior-driven",
+    "southpaw"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/solidsnail/southpaw"
+  },
+  "license": "MIT",
+  "author": "solidsnail",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@inquirer/prompts": "^7.4.0",
+    "@mantine/core": "^7.11.1",
+    "@mantine/hooks": "^7.17.2",
+    "@mantine/modals": "^7.11.1",
+    "@tabler/icons-react": "^3.31.0",
+    "dexie": "^3.2.4",
+    "express": "^5.1.0",
+    "fast-glob": "^3.3.3",
+    "kill-port": "^2.0.1",
+    "ollama": "^0.5.16",
+    "puppeteer": "^24.4.0",
+    "react-fast-compare": "^3.2.2",
+    "shelljs": "^0.9.2",
+    "shiki": "^3.4.2",
+    "ts-morph": "^25.0.1",
+    "webfontloader": "^1.6.28"
+  },
+  "devDependencies": {
+    "@types/shelljs": "^0.8.15",
+    "@types/webfontloader": "^1.6.38",
+    "husky": "^9.1.7"
+  },
+  "peerDependencies": {
+    "next": "^15.2.4"
+  }
+}