@wikex/admin-kit 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 Các thay đổi đáng chú ý của `@wikex/admin-kit` được ghi tại đây theo Semantic Versioning.
 
+## 0.3.0 - 2026-09-13
+
+- Thêm project scanner để phát hiện route Next.js và component React ở build-time.
+- Component có metadata `defineWikexBlock()` hoặc hậu tố `.wikex` được đánh dấu có thể cấu hình trong CMS.
+
 ## 0.2.1 - 2026-09-12
 
 - Publish JavaScript build và type declarations để Payload CLI chạy được trong project độc lập.

package/dist/scanner.d.ts

@@ -0,0 +1,23 @@
+type WikexDiscoveredRoute = {
+    dynamic: boolean;
+    file: string;
+    route: string;
+    title: string;
+};
+type WikexDiscoveredComponent = {
+    editable: boolean;
+    file: string;
+    name: string;
+};
+type WikexProjectInventory = {
+    components: WikexDiscoveredComponent[];
+    routes: WikexDiscoveredRoute[];
+};
+type ScanWikexProjectOptions = {
+    appDirectory?: string;
+    componentsDirectory?: string;
+    cwd?: string;
+};
+declare const scanWikexProject: ({ appDirectory, componentsDirectory, cwd, }?: ScanWikexProjectOptions) => Promise<WikexProjectInventory>;
+
+export { type ScanWikexProjectOptions, type WikexDiscoveredComponent, type WikexDiscoveredRoute, type WikexProjectInventory, scanWikexProject };

package/dist/scanner.js

@@ -0,0 +1,72 @@
+// src/scanner.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+var walk = async (directory) => {
+  try {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = await Promise.all(
+      entries.map((entry) => {
+        const target = path.join(directory, entry.name);
+        return entry.isDirectory() ? walk(target) : Promise.resolve([target]);
+      })
+    );
+    return files.flat();
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+};
+var routeTitle = (route) => {
+  if (route === "/") return "Trang ch\u1EE7";
+  return route.split("/").filter(Boolean).at(-1).replace(/\[(?:\.\.\.)?([^\]]+)\]/g, "$1").replace(/[-_]/g, " ").replace(/\b\p{L}/gu, (letter) => letter.toUpperCase());
+};
+var exportedComponentNames = (source, fallback) => {
+  const names = /* @__PURE__ */ new Set();
+  for (const match of source.matchAll(/export\s+(?:default\s+)?(?:async\s+)?function\s+([A-Z]\w*)/g)) {
+    names.add(match[1]);
+  }
+  for (const match of source.matchAll(/export\s+const\s+([A-Z]\w*)\s*=/g)) {
+    names.add(match[1]);
+  }
+  const defaultMatch = source.match(/export\s+default\s+([A-Z]\w*)/);
+  if (defaultMatch) names.add(defaultMatch[1] || fallback);
+  return [...names];
+};
+var scanWikexProject = async ({
+  appDirectory = "src/app",
+  componentsDirectory = "src/components",
+  cwd = process.cwd()
+} = {}) => {
+  const appRoot = path.resolve(cwd, appDirectory);
+  const componentRoot = path.resolve(cwd, componentsDirectory);
+  const [appFiles, componentFiles] = await Promise.all([walk(appRoot), walk(componentRoot)]);
+  const routes = appFiles.filter((file) => /[/\\]page\.(?:tsx?|jsx?)$/.test(file)).map((file) => {
+    const relative = path.relative(appRoot, file).replace(/\\/g, "/");
+    const directory = relative.replace(/(?:^|\/)page\.(?:tsx?|jsx?)$/, "");
+    const segments = directory.split("/").filter((segment) => segment && !/^\(.+\)$/.test(segment) && !segment.startsWith("@"));
+    const route = `/${segments.join("/")}`.replace(/\/$/, "") || "/";
+    return {
+      dynamic: route.includes("["),
+      file: relative,
+      route,
+      title: routeTitle(route)
+    };
+  }).filter(({ route }) => !route.startsWith("/admin")).sort((left, right) => left.route.localeCompare(right.route));
+  const components = (await Promise.all(
+    componentFiles.filter((file) => /\.(?:tsx|jsx)$/.test(file)).map(async (file) => {
+      const relative = path.relative(componentRoot, file).replace(/\\/g, "/");
+      const source = await readFile(file, "utf8");
+      const fallback = path.basename(file).replace(/\.wikex\.(?:tsx|jsx)$|\.(?:tsx|jsx)$/g, "");
+      const editable = /\.wikex\.(?:tsx|jsx)$/.test(file) || /\bdefineWikexBlock\s*\(/.test(source);
+      return exportedComponentNames(source, fallback).map((name) => ({
+        editable,
+        file: relative,
+        name
+      }));
+    })
+  )).flat().sort((left, right) => left.name.localeCompare(right.name) || left.file.localeCompare(right.file));
+  return { components, routes };
+};
+export {
+  scanWikexProject
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wikex/admin-kit",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Reusable Payload CMS admin shell, visual editor and typography tools for Wikex projects",
   "license": "UNLICENSED",
   "private": false,
@@ -36,6 +36,7 @@
     "./project": "./dist/project.js",
     "./rich-text": "./dist/rich-text.js",
     "./rich-text/client": "./dist/rich-text-client.js",
+    "./scanner": "./dist/scanner.js",
     "./starter": "./dist/starter.js",
     "./starter/client": "./dist/starter-client.js",
     "./styles": "./src/styles/admin.scss",