fromsrc 0.0.0 → 0.0.1

package/dist/webhook.js

@@ -0,0 +1,67 @@
+function sign(secret, timestamp) {
+  return btoa(`${secret}${timestamp}`);
+}
+function isrecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function istype(value) {
+  return value === "created" || value === "updated" || value === "deleted";
+}
+function isevent(value) {
+  if (!isrecord(value)) return false;
+  if (!istype(value.type)) return false;
+  if (typeof value.path !== "string") return false;
+  if (typeof value.timestamp !== "number" || !Number.isFinite(value.timestamp)) return false;
+  if (value.metadata !== void 0 && !isrecord(value.metadata)) return false;
+  return true;
+}
+function parsets(payload) {
+  try {
+    const raw = JSON.parse(payload);
+    if (Array.isArray(raw)) {
+      const first = raw[0];
+      return isevent(first) ? first.timestamp : null;
+    }
+    return isevent(raw) ? raw.timestamp : null;
+  } catch {
+    return null;
+  }
+}
+function verifySignature(payload, signature, secret) {
+  const ts = parsets(payload);
+  if (ts === null) return false;
+  return sign(secret, ts) === signature;
+}
+function createEventFromChange(type, path, meta) {
+  return { type, path, timestamp: Date.now(), ...meta && { metadata: meta } };
+}
+function filterEvents(config, events) {
+  const allowed = config.events;
+  if (!allowed) return events;
+  return events.filter((e) => allowed.includes(e.type));
+}
+async function dispatch(config, body, type) {
+  const headers = {
+    "Content-Type": "application/json",
+    "X-Webhook-Event": type
+  };
+  const ts = parsets(body) ?? 0;
+  if (config.secret) {
+    headers["X-Webhook-Signature"] = sign(config.secret, ts);
+  }
+  const start = performance.now();
+  try {
+    const res = await fetch(config.url, { method: "POST", headers, body });
+    return { success: res.ok, status: res.status, duration: performance.now() - start };
+  } catch {
+    return { success: false, status: 0, duration: performance.now() - start };
+  }
+}
+function createWebhook(config) {
+  return {
+    send: (event) => dispatch(config, JSON.stringify(event), event.type),
+    sendBatch: (events) => dispatch(config, JSON.stringify(events), events.map((e) => e.type).join(","))
+  };
+}
+
+export { createEventFromChange, createWebhook, filterEvents, verifySignature };

package/dist/workspace.d.ts

@@ -0,0 +1,26 @@
+interface WorkspacePackage {
+    name: string;
+    path: string;
+    docsDir: string;
+    slug: string;
+}
+interface WorkspaceConfig {
+    root: string;
+    packages: string[];
+    docsDir?: string;
+}
+interface WorkspaceResult {
+    packages: WorkspacePackage[];
+    navigation: WorkspaceNavItem[];
+}
+interface WorkspaceNavItem {
+    label: string;
+    slug: string;
+    children?: WorkspaceNavItem[];
+}
+declare function discoverPackages(config: WorkspaceConfig): Promise<WorkspacePackage[]>;
+declare function buildWorkspaceNav(packages: WorkspacePackage[]): WorkspaceNavItem[];
+declare function resolveWorkspacePath(packages: WorkspacePackage[], slug: string): string | null;
+declare function mergeNavigation(sections: WorkspaceNavItem[][]): WorkspaceNavItem[];
+
+export { type WorkspaceConfig, type WorkspaceNavItem, type WorkspacePackage, type WorkspaceResult, buildWorkspaceNav, discoverPackages, mergeNavigation, resolveWorkspacePath };

package/dist/workspace.js

@@ -0,0 +1,81 @@
+import { readFile, stat, readdir } from 'node:fs/promises';
+import { resolve, join, basename } from 'node:path';
+
+function isrecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parsename(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (!isrecord(parsed)) return null;
+    const name = parsed.name;
+    return typeof name === "string" && name.length > 0 ? name : null;
+  } catch {
+    return null;
+  }
+}
+async function matchGlob(root, pattern) {
+  const parts = pattern.split("/");
+  let dirs = [root];
+  for (const part of parts) {
+    const next = [];
+    for (const dir of dirs) {
+      if (part === "*") {
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const e of entries) {
+          if (e.isDirectory() && !e.name.startsWith(".")) {
+            next.push(join(dir, e.name));
+          }
+        }
+      } else {
+        const full = join(dir, part);
+        const s = await stat(full).catch(() => null);
+        if (s?.isDirectory()) next.push(full);
+      }
+    }
+    dirs = next;
+  }
+  return dirs;
+}
+async function discoverPackages(config) {
+  const docsDir = config.docsDir ?? "docs";
+  const root = resolve(config.root);
+  const results = [];
+  for (const pattern of config.packages) {
+    const dirs = await matchGlob(root, pattern);
+    for (const dir of dirs) {
+      const pkgPath = join(dir, "package.json");
+      const raw = await readFile(pkgPath, "utf-8").catch(() => null);
+      if (!raw) continue;
+      const name = parsename(raw) ?? basename(dir);
+      const docs = join(dir, docsDir);
+      const exists = await stat(docs).catch(() => null);
+      if (!exists?.isDirectory()) continue;
+      results.push({ name, path: dir, docsDir: docs, slug: basename(dir) });
+    }
+  }
+  return results;
+}
+function buildWorkspaceNav(packages) {
+  return packages.map((pkg) => ({
+    label: pkg.name,
+    slug: pkg.slug,
+    children: []
+  }));
+}
+function resolveWorkspacePath(packages, slug) {
+  const [pkgSlug, ...rest] = slug.split("/");
+  const pkg = packages.find((p) => p.slug === pkgSlug);
+  if (!pkg) return null;
+  const file = rest.length > 0 ? rest.join("/") : "index";
+  return join(pkg.docsDir, `${file}.mdx`);
+}
+function mergeNavigation(sections) {
+  const merged = [];
+  for (const section of sections) {
+    for (const item of section) merged.push(item);
+  }
+  return merged;
+}
+
+export { buildWorkspaceNav, discoverPackages, mergeNavigation, resolveWorkspacePath };

package/package.json

@@ -1,12 +1,139 @@
 {
-  "name": "fromsrc",
-  "version": "0.0.0",
-  "description": "Reserved package name",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": ["placeholder", "reserved"],
-  "author": "josh",
-  "license": "MIT"
-}
+	"name": "fromsrc",
+	"version": "0.0.1",
+	"description": "documentation framework for developers",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/fromsrc/fromsrc"
+	},
+	"homepage": "https://github.com/fromsrc/fromsrc",
+	"bugs": {
+		"url": "https://github.com/fromsrc/fromsrc/issues"
+	},
+	"type": "module",
+	"sideEffects": false,
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./client": {
+			"types": "./dist/client.d.ts",
+			"import": "./dist/client.js"
+		},
+		"./next": {
+			"types": "./dist/next.d.ts",
+			"import": "./dist/next.js"
+		},
+		"./react-router": {
+			"types": "./dist/reactrouter.d.ts",
+			"import": "./dist/reactrouter.js"
+		},
+		"./vite": {
+			"types": "./dist/vite.d.ts",
+			"import": "./dist/vite.js"
+		},
+		"./tanstack": {
+			"types": "./dist/tanstack.d.ts",
+			"import": "./dist/tanstack.js"
+		},
+		"./remix": {
+			"types": "./dist/remix.d.ts",
+			"import": "./dist/remix.js"
+		},
+		"./astro": {
+			"types": "./dist/astro.d.ts",
+			"import": "./dist/astro.js"
+		},
+		"./readtime": {
+			"types": "./dist/readtime.d.ts",
+			"import": "./dist/readtime.js"
+		},
+		"./searchscore": {
+			"types": "./dist/searchscore.d.ts",
+			"import": "./dist/searchscore.js"
+		},
+		"./searchindex": {
+			"types": "./dist/searchindex.d.ts",
+			"import": "./dist/searchindex.js"
+		},
+		"./searchpolicy": {
+			"types": "./dist/searchpolicy.d.ts",
+			"import": "./dist/searchpolicy.js"
+		},
+		"./llms": {
+			"types": "./dist/llms.d.ts",
+			"import": "./dist/llms.js"
+		},
+		"./openapi": {
+			"types": "./dist/openapi.d.ts",
+			"import": "./dist/openapi.js"
+		},
+		"./algolia": {
+			"types": "./dist/algolia.d.ts",
+			"import": "./dist/algolia.js"
+		},
+		"./orama": {
+			"types": "./dist/orama.d.ts",
+			"import": "./dist/orama.js"
+		},
+		"./styles/reset.css": "./styles/reset.css"
+	},
+	"files": [
+		"dist",
+		"styles"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch"
+	},
+	"dependencies": {
+		"@mdx-js/mdx": "^3.1.0",
+		"@shikijs/rehype": "^3.0.0",
+		"@shikijs/transformers": "^3.22.0",
+		"gray-matter": "^4.0.3",
+		"next-mdx-remote": "^6.0.0",
+		"remark-gfm": "^4.0.1",
+		"shiki": "^3.0.0",
+		"unist-util-visit": "^5.1.0",
+		"zod": "^3.24.0"
+	},
+	"devDependencies": {
+		"@remix-run/react": "^2.17.1",
+		"@tanstack/react-router": "^1.133.42",
+		"@types/hast": "^3.0.4",
+		"@types/mdast": "^4.0.4",
+		"@types/node": "^22.0.0",
+		"@types/react": "^19.0.0",
+		"react-router": "^7.9.5",
+		"tsup": "^8.5.0",
+		"typescript": "^5.9.0",
+		"unified": "^11.0.5"
+	},
+	"peerDependencies": {
+		"@remix-run/react": ">=2.0.0",
+		"mermaid": ">=10.0.0",
+		"katex": ">=0.16.0",
+		"next": ">=14.0.0",
+		"react": ">=18.0.0",
+		"@tanstack/react-router": ">=1.0.0",
+		"react-router": ">=7.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@remix-run/react": {
+			"optional": true
+		},
+		"mermaid": {
+			"optional": true
+		},
+		"katex": {
+			"optional": true
+		},
+		"@tanstack/react-router": {
+			"optional": true
+		},
+		"react-router": {
+			"optional": true
+		}
+	}
+}

package/styles/reset.css

@@ -0,0 +1,3 @@
+*:focus {
+	outline: none;
+}

package/index.js

@@ -1,3 +0,0 @@
-export default function() {
-  console.log('This package is reserved');
-}