@akanjs/cli 0.9.42 → 0.9.44

package/src/guidelines/___library/sharedUiStructureDescription.en.md

@@ -733,7 +733,6 @@ SlateContent
 Purpose: Metadata-driven property editing
 
 - prop: string - Property name
-- slice: StoreOf<any, any> - Store slice
 - renderTemplate?: (form: any) => ReactNode - Custom edit renderer
 - renderView?: (model: any) => ReactNode - Custom view renderer
 - modelPath?: string - Model path in store

package/src/guidelines/componentRule/componentRule.instruction.md

@@ -519,28 +519,10 @@ export const General = () => {
 ```tsx
 "use client";
 import { ModelDashboardProps } from "@akanjs/client";
-import { getQueryMap } from "@akanjs/constant";
 import { cnst, st } from "@app/client";
 import { Data } from "@akanjs/ui";
 import { Button } from "@akanjs/ui";
 
-export const Stat = ({
-  className,
-  summary,
-  sliceName = "product",
-  queryMap = getQueryMap(cnst.ProductSummary),
-}: ModelDashboardProps<cnst.Summary>) => {
-  return (
-    <Data.Dashboard
-      className={className}
-      summary={summary}
-      sliceName={sliceName}
-      queryMap={queryMap}
-      columns={["totalProducts", "inStock", "outOfStock"]}
-    />
-  );
-};
-
 export const AddToCart = ({ productId, className }: { productId: string; className?: string }) => {
   return (
     <Button className={clsx("bg-primary text-white", className)} onClick={() => st.do.addToCart(productId)}>

package/src/guidelines/cssRule/cssRule.instruction.md

@@ -200,8 +200,8 @@ Detailed displays of full data models:
 export const Detail = ({ className, project }: ModelProps<"project", cnst.FullProject>) => {
   return (
     <div className={clsx("bg-base-100 rounded-lg p-6 shadow-lg", className)}>
-      <div className="border-primary mb-6 border-l-4 pl-4">
-        <h1 className="text-primary text-2xl font-bold">{project.name}</h1>
+      <div className="border-base-content mb-8">
+        <h1 className="text-2xl font-bold">{project.name}</h1>
       </div>
 
       <div className="grid grid-cols-1 gap-6 md:grid-cols-2">{/* Project details */}</div>

package/src/guidelines/databaseModule/databaseModule.instruction.md

@@ -97,7 +97,7 @@ import { dayjs } from "@akanjs/base";
 import { beyond, by, Database, into, Loader, type SchemaOf } from "@akanjs/document";
 import { hashPassword } from "@shared/nest";
 
-import { cnst } from "../cnst";
+import * as cnst from "../cnst";
 
 // Input model for database operations
 @Database.Input(() => cnst.UserInput)
@@ -119,7 +119,7 @@ export class User extends by(cnst.User) {
 
 // Model with database operations
 @Database.Model(() => cnst.User)
-export class UserModel extends into(User, cnst.userCnst) {
+export class UserModel extends into(User, cnst.userCnst, ...user.models) {
   @Loader.ByField("email") userEmailLoader: Loader<string, User>;
 
   async findByEmail(email: string) {
@@ -162,7 +162,7 @@ import { DbService, Service, Srv, Use } from "@akanjs/service";
 import { Account, type Me } from "@akanjs/signal";
 import { isPasswordMatch } from "@shared/nest";
 
-import { cnst } from "../cnst";
+import * as cnst from "../cnst";
 import * as db from "../db";
 import type * as option from "../option";
 import type * as srv from "../srv";
@@ -208,11 +208,11 @@ Define GraphQL operations in the signal:
 import { ID } from "@akanjs/base";
 import { Account, Arg, DbSignal, Me, Mutation, Query, resolve, Signal } from "@akanjs/signal";
 
-import { cnst, Srvs } from "../cnst";
+import * as cnst from "../cnst";
 import type * as db from "../db";
 
 @Signal(() => cnst.User)
-export class UserSignal extends DbSignal(cnst.userCnst, Srvs, {
+export class UserSignal extends DbSignal(cnst.userCnst, cnst.Srvs, {
   guards: { get: Query.Public, cru: Mutation.Admin },
 }) {
   @Mutation.Public(() => cnst.util.AccessToken)
@@ -256,8 +256,8 @@ Implement client-side state management:
 import { StateCreator } from "zustand";
 import { immer } from "zustand/middleware/immer";
 
-import { cnst } from "../cnst";
-import * as fetch from "../fetch";
+import * as cnst from "../cnst";
+import * as fetch from "../sig";
 
 export interface UserState {
   users: cnst.User[];
@@ -584,30 +584,36 @@ export const Layout = () => (
 ## Best Practices
 
 1. **Naming Conventions**
+
    - Use PascalCase for classes and components (e.g., `UserService`, `User.Unit.tsx`)
    - Use camelCase for files (e.g., `user.service.ts`, `user.document.ts`)
 
 2. **Security**
+
    - Use `@Field.Secret` for sensitive data like passwords
    - Apply proper permission guards to queries and mutations (`@Query.Admin`, `@Mutation.Public`)
    - Validate input data using the `validate` option in `@Field.Prop`
 
 3. **Code Organization**
+
    - Keep business logic in service files
    - Use signals for API calls only, not for business logic
    - Define reusable utility methods in document models
 
 4. **Performance**
+
    - Use dataloader pattern (`@Loader.ByField`) for efficient database access
    - Create proper indexes in the middleware
    - Use projections to limit returned fields when appropriate
 
 5. **Testing**
+
    - Create signal tests for each API endpoint
    - Mock services for unit testing signals
    - Use integration tests for testing complex workflows
 
 6. **UI Components**
+
    - Follow the separation between Template, Unit, View, and Zone components
    - Make components reusable across different parts of the application
    - Use dictionary files for all UI text to support internationalization

package/src/guidelines/modelConstant/modelConstant.instruction.md

@@ -84,13 +84,6 @@ export class DroneInsight {
   count: number;
 }
 
-// 8. Summary Model
-@Model.Summary("DroneSummary")
-export class DroneSummary {
-  @Field.Prop(() => Int, { min: 0, default: 0, query: { status: { $ne: "inactive" } } })
-  totalDrone: number;
-}
-
 // 9. Query Model
 export const droneQuery = {
   byName: (name: string) => ({ name }),
@@ -253,18 +246,6 @@ const droneInsight = await fetch.droneInsight({ ...query });
 const droneInsight = st.use.droneInsight(); // droneInsight.count
 ```
 
-## Summary Model Implementation
-
-Summary model defines periodic statistics:
-
-```typescript
-@Model.Summary("DroneSummary")
-export class DroneSummary {
-  @Field.Prop(() => Int, { min: 0, default: 0, query: { status: { $ne: "inactive" } } })
-  totalDrone: number;
-}
-```
-
 **Usage Examples**:
 
 ```typescript
@@ -436,7 +417,6 @@ import { LightMission } from "../cnst_";
 ## Best Practices for Maintainable Models
 
 1. **Consistent Naming**:
-
    - Input: `DroneInput`
    - Object: `DroneObject`
    - Light: `LightDrone`
@@ -444,19 +424,16 @@ import { LightMission } from "../cnst_";
    - Sort: `droneSort`
 
 2. **Reference Handling**:
-
    - Use Light models for references
    - Avoid circular dependencies
    - Prefer direct imports over barrel files
 
 3. **Field Design**:
-
    - Use proper field types (Prop, Hidden, Secret, Resolve)
    - Set appropriate defaults (especially for arrays)
    - Add validation where needed
 
 4. **Performance Optimization**:
-
    - Use Light models for list queries
    - Keep Insight/Summary models lean
    - Use appropriate indexes for queries
@@ -509,13 +486,6 @@ export class DroneInsight {
   count: number;
 }
 
-// Summary Model
-@Model.Summary("DroneSummary")
-export class DroneSummary {
-  @Field.Prop(() => Int, { query: { status: "active" } })
-  activeDrones: number;
-}
-
 // Query Model
 export const droneQuery = {
   byStatus: (status: string) => ({ status }),

package/src/guidelines/modelDictionary/modelDictionary.instruction.md

@@ -18,13 +18,7 @@ This system ensures consistent terminology across all application layers and sup
 ## 2. File Structure
 
 ```typescript
-import {
-  ModelDictionary,
-  SignalDictionary,
-  SummaryDictionary,
-  baseTrans,
-  getBaseSignalTrans,
-} from "@akanjs/dictionary";
+import { ModelDictionary, SignalDictionary, baseTrans, getBaseSignalTrans } from "@akanjs/dictionary";
 
 import type { YourModel, YourFilter, YourInsight, YourSummary } from "./your-model.constant";
 import type { YourSignal } from "./your-model.signal";
@@ -59,14 +53,6 @@ const modelDictionary = {
   // * ==================== Etc ==================== * //
 } satisfies ModelDictionary<YourModel, YourInsight, YourFilter>;
 
-// Summary model translations (optional)
-export const yourSummaryDictionary = {
-  // * ==================== Summary ==================== * //
-  totalItems: ["Total Items", "총 항목 수"],
-  "desc-totalItems": ["Total item count in database", "데이터베이스의 총 항목 수"],
-  // * ==================== Summary ==================== * //
-} satisfies SummaryDictionary<YourSummary>;
-
 // API endpoint translations
 const signalDictionary = {
   ...getBaseSignalTrans("modelName"), // Auto-generate standard API texts
@@ -341,7 +327,6 @@ Always include these imports in your dictionary file:
 import {
   ModelDictionary,
   SignalDictionary,
-  SummaryDictionary,
   ExtendModelDictionary, // For extended models
   baseTrans, // Common translations
   getBaseSignalTrans, // Auto-generated API translations
@@ -358,17 +343,10 @@ import type { YourSummary } from "./your-model.summary"; // If using summary
 ## 10. Full Example of model.dictionary.ts
 
 ```typescript
-import {
-  ModelDictionary,
-  SignalDictionary,
-  SummaryDictionary,
-  baseTrans,
-  getBaseSignalTrans,
-} from "@akanjs/dictionary";
+import { ModelDictionary, SignalDictionary, baseTrans, getBaseSignalTrans } from "@akanjs/dictionary";
 
 import type { Post, PostFilter, PostInsight } from "./post.constant";
 import type { PostSignal } from "./post.signal";
-import type { PostSummary } from "./post.summary";
 
 const modelDictionary = {
   ...baseTrans,
@@ -438,19 +416,6 @@ const modelDictionary = {
   // * ==================== Etc ==================== * //
 } satisfies ModelDictionary<Post, PostInsight, PostFilter>;
 
-export const postSummaryDictionary = {
-  // * ==================== Summary ==================== * //
-  totalPosts: ["Total Posts", "총 게시물 수"],
-  "desc-totalPosts": ["Total post count in database", "데이터베이스의 총 게시물 수"],
-
-  publishedPosts: ["Published Posts", "게시된 게시물 수"],
-  "desc-publishedPosts": ["Number of published posts", "게시된 게시물 수"],
-
-  draftPosts: ["Draft Posts", "초안 게시물 수"],
-  "desc-draftPosts": ["Number of draft posts", "초안 게시물 수"],
-  // * ==================== Summary ==================== * //
-} satisfies SummaryDictionary<PostSummary>;
-
 const signalDictionary = {
   ...getBaseSignalTrans("post"),
 
@@ -573,7 +538,6 @@ export const settingDictionary = userSettingDictionary;
 7. **Validate Dictionary**: Run `akan dict:check` before committing changes
 
 8. **Consistent Casing**:
-
    - Model field names: camelCase
    - Enum values: camelCase
    - Custom keys: camelCase

package/src/guidelines/modelDocument/modelDocument.instruction.md

@@ -495,7 +495,7 @@ Here's a complete example integrating multiple features:
 // product.document.ts
 import { dayjs } from "@akanjs/base";
 import { beyond, by, Database, into, Loader, SchemaOf } from "@akanjs/document";
-import { cnst } from "../cnst";
+import * as cnst from "../cnst";
 
 @Database.Input(() => cnst.ProductInput)
 export class ProductInput extends by(cnst.ProductInput) {}

package/src/guidelines/modelService/modelService.instruction.md

@@ -136,97 +136,6 @@ Injects a websocket server instance for real-time communication:
 protected readonly websocket: Websocket<ChatSignal>;
 ```
 
-## Lifecycle Methods
-
-Akan.js services can implement lifecycle hooks that are called by the NestJS framework.
-
-### onModuleInit()
-
-Called once the module has been initialized by NestJS. Use this for setup operations:
-
-```typescript
-async onModuleInit() {
-  // Initialize service resources
-  await this.loadInitialData();
-  this.setupEventListeners();
-  this.logger.log('Service initialized successfully');
-}
-```
-
-Common use cases:
-
-- Initializing in-memory cache
-- Setting up event listeners
-- Loading configuration data
-- Establishing connections to external services
-
-### onModuleDestroy()
-
-Called just before the application shuts down. Use this for cleanup operations:
-
-```typescript
-async onModuleDestroy() {
-  // Clean up resources
-  await Promise.all(this.connections.map(conn => conn.close()));
-  this.clearTimers();
-  this.logger.log('Service resources released');
-}
-```
-
-Common use cases:
-
-- Closing database connections
-- Releasing external resources
-- Clearing timers and intervals
-- Unregistering event listeners
-
-## Scheduled Tasks
-
-Akan.js provides decorators for scheduling recurring tasks.
-
-### @Cron Decorator
-
-Executes methods on a cron schedule:
-
-```typescript
-@Cron("0 0 * * *")  // Run at midnight every day
-async dailyCleanup() {
-  await this.cleanupExpiredRecords();
-  this.logger.log('Daily cleanup completed');
-}
-
-@Cron("*/5 * * * *", { serverMode: "batch" })  // Run every 5 minutes, only in batch mode
-async periodicSync() {
-  await this.syncExternalData();
-}
-```
-
-The first parameter uses standard cron syntax:
-
-- `* * * * *` = minute hour day-of-month month day-of-week
-- Special patterns like `@daily`, `@hourly` are also supported
-
-Options include:
-
-- `serverMode`: Restrict to a specific server mode (e.g., "batch")
-- `name`: Assign a name to the scheduled job
-- `timeZone`: Specify the timezone for the schedule
-
-### @Interval Decorator
-
-Executes methods at fixed time intervals in milliseconds:
-
-```typescript
-@Interval(60000)  // Run every minute (60,000 ms)
-async checkStatus() {
-  await this.monitorSystemHealth();
-}
-```
-
-Options:
-
-- `name`: Assign a name to the interval
-
 ## Database Operations
 
 When extending `DbService`, your service automatically inherits numerous methods for working with the database model.
@@ -606,34 +515,6 @@ class PaymentService extends DbService(db.paymentDb) {
 }
 ```
 
-### 3. Proper Resource Management
-
-Clean up resources in lifecycle hooks:
-
-```typescript
-@Service("ExternalApiService")
-class ExternalApiService extends LogService("ExternalApiService") {
-  private client: ApiClient;
-  private timers: NodeJS.Timeout[] = [];
-
-  async onModuleInit() {
-    this.client = new ApiClient();
-    await this.client.connect();
-
-    this.timers.push(setInterval(() => this.refreshToken(), 3600000));
-  }
-
-  async onModuleDestroy() {
-    // Clean up resources
-    await this.client.disconnect();
-
-    for (const timer of this.timers) {
-      clearInterval(timer);
-    }
-  }
-}
-```
-
 ### 4. Transaction Safety
 
 Use hooks for validating operations:
@@ -724,7 +605,7 @@ import { Cron } from "@akanjs/nest";
 import { DbService, Service, Srv, Use } from "@akanjs/service";
 import type { EmailApi } from "@util/nest";
 
-import { cnst } from "../cnst";
+import * as cnst from "../cnst";
 import * as db from "../db";
 import { Revert } from "../dict";
 import type * as srv from "../srv";
@@ -818,25 +699,6 @@ export class OrderService extends DbService(db.orderDb) {
 
     return data;
   }
-
-  // Scheduled task
-  @Cron("0 0 * * *", { serverMode: "batch" })
-  async cleanupAbandonedOrders() {
-    const cutoffDate = dayjs().subtract(7, "days");
-    const orders = await this.listPendingOrders(cutoffDate);
-
-    for (const order of orders) {
-      await this.cancelOrder(order.id);
-      this.logger.log(`Cancelled abandoned order: ${order.id}`);
-    }
-  }
-
-  // Summary method
-  async summarize(): Promise<cnst.OrderSummary> {
-    return {
-      ...(await this.orderModel.getSummary()),
-    };
-  }
 }
 ```
 
@@ -894,32 +756,6 @@ If a service isn't being injected correctly:
    }
    ```
 
-### Scheduled Tasks Not Running
-
-1. Verify cron syntax:
-
-   ```typescript
-   // Correct syntax
-   @Cron("0 * * * *")  // Every hour at minute 0
-
-   // Incorrect syntax
-   @Cron("0 * * *")  // Missing day-of-week field
-   ```
-
-2. Check server mode restrictions:
-
-   ```typescript
-   // Only runs in batch mode
-   @Cron("0 * * * *", { serverMode: "batch" })
-   ```
-
-3. Ensure the service is properly initialized:
-   ```typescript
-   onModuleInit() {
-     this.logger.log('Service initialized');  // Is this being logged?
-   }
-   ```
-
 ## Summary
 
 Model services in Akan.js are powerful components that encapsulate business logic and data operations. By following the patterns and best practices outlined in this guide, you can create maintainable, scalable services that effectively implement your application's domain logic while maintaining clean separation of concerns.

package/src/guidelines/modelSignal/modelSignal.instruction.md

@@ -23,11 +23,11 @@ import { ID, Int } from "@akanjs/base";
 import { SortOf } from "@akanjs/constant";
 import { Arg, DbSignal, Mutation, Query, resolve, Self, Signal } from "@akanjs/signal";
 
-import { cnst, Srvs } from "../cnst";
+import * as cnst from "../cnst";
 import type * as db from "../db";
 
 @Signal(() => cnst.ModelName)
-export class ModelNameSignal extends DbSignal(cnst.modelNameCnst, Srvs, {
+export class ModelNameSignal extends DbSignal(cnst.modelNameCnst, cnst.Srvs, {
   guards: { get: Query.Public, cru: Mutation.User },
 }) {
   // Signal methods here...
@@ -289,7 +289,7 @@ DbSignal creates standard operations that you don't need to implement:
 
 ```typescript
 @Signal(() => cnst.Board)
-export class BoardSignal extends DbSignal(cnst.boardCnst, Srvs, {
+export class BoardSignal extends DbSignal(cnst.boardCnst, cnst.Srvs, {
   guards: { get: Query.Public, cru: Mutation.Admin },
 }) {
   // Custom methods beyond CRUD go here
@@ -409,7 +409,7 @@ async getProjectDetails(
 
 ```typescript
 @Signal(() => cnst.Product)
-export class ProductSignal extends DbSignal(cnst.productCnst, Srvs, {
+export class ProductSignal extends DbSignal(cnst.productCnst, cnst.Srvs, {
   guards: { get: Query.Public, cru: Mutation.Admin },
 }) {
   // Custom methods beyond auto-generated CRUD

package/src/guidelines/modelStore/modelStore.instruction.md

@@ -34,8 +34,8 @@ Model stores follow a consistent architecture pattern:
 
 ```typescript
 import { stateOf, Store } from "@akanjs/store";
-import { cnst } from "../cnst";
-import { fetch } from "../fetch";
+import * as cnst from "../cnst";
+import { fetch } from "../sig";
 
 @Store(() => cnst.Product)
 export class ProductStore extends stateOf(fetch.productGql, {
@@ -485,8 +485,8 @@ initProductChat(productId: string) {
 
 ```typescript
 import { stateOf, Store, Toast } from "@akanjs/store";
-import { cnst } from "../cnst";
-import { fetch } from "../fetch";
+import * as cnst from "../cnst";
+import { fetch } from "../sig";
 import { msg } from "../msg";
 
 @Store(() => cnst.Product)

package/src/templates/lib/cnst.d.ts

@@ -1,4 +1,4 @@
 import type { AppInfo, LibInfo } from "@akanjs/devkit";
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict?: {
     [key: string]: string;
-}): string;
+}): string | null;

package/ui/MultiScrollList.d.ts

@@ -2,7 +2,10 @@ import React from "react";
 interface MultiScrollListProps {
     logList: {
         title: string;
-        logs: string[];
+        logs: {
+            type: string;
+            content: string;
+        }[];
         color: string;
     }[];
     maxLength?: number;

package/cjs/src/templates/app/app/[lang]/admin/page.js

@@ -1,63 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// pkgs/@akanjs/cli/src/templates/app/app/[lang]/admin/page.tsx
-var page_exports = {};
-__export(page_exports, {
-  default: () => getContent
-});
-module.exports = __toCommonJS(page_exports);
-function getContent(scanInfo, dict) {
-  return {
-    filename: "page.tsx",
-    content: `
-"use client";
-import { Admin } from "@shared/client";
-import { User, st } from "@${dict.appName}/client";
-
-export default function Page() {
-  const me = st.use.me();
-  return (
-    <Admin.Zone.Layout
-      password
-      // ssoTypes={["google"]}
-      logo={<div className="text-white ">${dict.appName}</div>}
-      pageMenus={[
-        {
-          key: "data",
-          title: "Data",
-          menus: [
-            // Admin.Menu.Admin,
-            // User.Menu.Admin,
-          ],
-        },
-        {
-          key: "api",
-          title: "API Doc",
-          menus: [
-            // Admin.Menu.Doc,
-            // User.Menu.Doc,
-          ],
-        },
-      ]}
-    />
-  );
-}
-  `
-  };
-}

package/cjs/src/templates/app/lib/setting/Setting.Template.js

@@ -1,44 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// pkgs/@akanjs/cli/src/templates/app/lib/setting/Setting.Template.tsx
-var Setting_Template_exports = {};
-__export(Setting_Template_exports, {
-  default: () => getContent
-});
-module.exports = __toCommonJS(Setting_Template_exports);
-function getContent(scanInfo, dict) {
-  return {
-    filename: "Setting.Template.tsx",
-    content: `
-"use client";
-import { clsx } from "@akanjs/client";
-import { st, usePage } from "@${dict.appName}/client";
-
-interface GeneralProps {
-  className?: string;
-}
-
-export const General = ({ className }: GeneralProps) => {
-  const settingForm = st.use.settingForm();
-  const { l } = usePage();
-  return <div className={clsx("", className)}></div>; // update your UI here
-};
-`
-  };
-}