kalo-cli 0.1.0

package/generators/wagtail-page/actions/snippet.ts

@@ -0,0 +1,19 @@
+import { ActionType } from 'plop';
+import { createAppendActions, ensureSuffix } from '../../utils/plop-actions';
+
+/**
+ * Generates Plop actions for creating a Wagtail Snippet.
+ *
+ * @param {any} data - The prompt answers data.
+ * @returns {ActionType[]} An array of Plop actions to create snippet files and tests.
+ */
+export const getSnippetActions = (data: any): ActionType[] => {
+  const appPath = `app/${data.app}`;
+  
+  data.name = ensureSuffix(data.name, 'Snippet');
+
+  return createAppendActions({
+      path: `${appPath}/models/snippets.py`,
+      templateFile: 'generators/wagtail-page/templates/snippet_model.py.hbs'
+  });
+};

package/generators/wagtail-page/index.ts

@@ -0,0 +1,63 @@
+import { PlopGeneratorConfig } from 'plop';
+import { getPageActions } from './actions/page';
+import { getOrderableActions } from './actions/orderable';
+import { getSnippetActions } from './actions/snippet';
+import { getModelActions } from './actions/model';
+import { WAGTAIL_PAGE_TYPES } from '../constants';
+import { searchChoices } from '../utils/search';
+
+/**
+ * Generator configuration for Wagtail Page Models and related components.
+ * Supports creation of:
+ * - Page Pairs (Index + Detail)
+ * - Orderable Models
+ * - Snippets
+ * - Standard Django Models
+ * Delegates action generation to specialized action helpers.
+ *
+ * @type {PlopGeneratorConfig}
+ */
+export const wagtailPageGenerator: PlopGeneratorConfig = {
+  description: 'Créer un modèle Wagtail Page (Paire Index/Detail), Orderable, ou Snippet',
+  prompts: [
+    {
+      type: 'autocomplete',
+      name: 'type',
+      message: 'Quel type de modèle voulez-vous créer ?',
+      source: (answers, input) => searchChoices(input, WAGTAIL_PAGE_TYPES),
+    },
+    {
+      type: 'input',
+      name: 'name',
+      message: (answers) => {
+        if (answers.type === 'page_pair') return 'Nom de base (ex: Blog -> BlogIndexPage, BlogPage) :';
+        if (answers.type === 'orderable') return 'Nom de l\'Orderable (ex: GalleryImage -> GalleryImageOrderable) :';
+        if (answers.type === 'snippet') return 'Nom du Snippet (ex: Category -> CategorySnippet) :';
+        return 'Nom du Modèle (ex: Product -> Product) :';
+      },
+      validate: (value, answers) => {
+          if (!value) return 'Le nom est requis';
+          return true;
+      }
+    },
+    {
+      type: 'input',
+      name: 'app',
+      message: 'Nom de l\'application cible',
+    },
+  ],
+  actions: (data) => {
+    switch (data.type) {
+      case 'page_pair':
+        return getPageActions(data);
+      case 'orderable':
+        return getOrderableActions(data);
+      case 'snippet':
+        return getSnippetActions(data);
+      case 'model':
+        return getModelActions(data);
+      default:
+        return [];
+    }
+  },
+};

package/generators/wagtail-page/templates/django_model.py.hbs

@@ -0,0 +1,18 @@
+
+class {{pascalCase name}}(models.Model):
+    """
+    {{pascalCase name}} standard Django model.
+    """
+
+    # <!-- CLASS = {{pascalCase name}} END AI_GENERATED_DJANGO_MODEL -->
+    # <!-- CLASS = {{pascalCase name}} START AI_GENERATED_DJANGO_MODEL -->
+
+    # Database fields
+    name = models.CharField(max_length=255)
+    
+    class Meta:
+        verbose_name = "{{titleCase name}}"
+        verbose_name_plural = "{{titleCase name}}s"
+
+    def __str__(self):
+        return self.name

package/generators/wagtail-page/templates/orderable_model.py.hbs

@@ -0,0 +1,21 @@
+
+class {{pascalCase name}}(Orderable):
+    """
+    {{pascalCase name}} orderable model.
+    """
+    # page = ParentalKey('app_label.PageModel', related_name='related_items', on_delete=models.CASCADE)
+
+    # <!-- CLASS = {{pascalCase name}} START AI_GENERATED_ORDERABLE_MODEL -->
+    # <!-- CLASS = {{pascalCase name}} END AI_GENERATED_ORDERABLE_MODEL -->
+
+    # Database fields
+    sort_order = models.IntegerField(null=True, blank=True, editable=False)
+    # Add your fields here
+    
+    panels = [
+        # FieldPanel('field_name'),
+    ]
+
+    class Meta:
+        verbose_name = "{{titleCase name}}"
+        verbose_name_plural = "{{titleCase name}}s"

package/generators/wagtail-page/templates/page_pair_model.py.hbs

@@ -0,0 +1,62 @@
+
+class {{pascalCase baseName}}IndexPage(Page):
+    """
+    Index page for {{pascalCase baseName}}.
+    """
+
+    # Parent page / subpage type rules
+    subpage_types = ['{{pascalCase baseName}}Page']
+    
+    # Database fields
+    intro = models.CharField(max_length=250, blank=True)
+    body = RichTextField(blank=True)
+
+    # Editor panels configuration
+    content_panels = Page.content_panels + [
+        FieldPanel('intro'),
+        FieldPanel('body'),
+    ]
+
+     # <!-- CLASS = {{pascalCase baseName}}IndexPage START AI_GENERATED_PAGE_INDEX -->
+     # <!-- CLASS = {{pascalCase baseName}}IndexPage END AI_GENERATED_PAGE_INDEX -->
+    
+    # Search index configuration
+    search_fields = Page.search_fields + [
+        index.SearchField('intro'),
+        index.SearchField('body'),
+    ]
+
+    class Meta:
+        verbose_name = "{{titleCase baseName}} Index"
+
+
+class {{pascalCase baseName}}Page(Page):
+    """
+    Detail page for {{pascalCase baseName}}.
+    """
+    
+    # Parent page / subpage type rules
+    parent_page_types = ['{{pascalCase baseName}}IndexPage']
+
+    # Database fields
+    intro = models.CharField(max_length=250, blank=True)
+    body = RichTextField(blank=True)
+
+    # Editor panels configuration
+    content_panels = Page.content_panels + [
+        FieldPanel('intro'),
+        FieldPanel('body'),
+    ]
+
+     # <!-- CLASS = {{pascalCase baseName}}Page START AI_GENERATED_PAGE -->
+     # <!-- CLASS = {{pascalCase baseName}}Page END AI_GENERATED_PAGE -->
+    
+  
+    # Search index configuration
+    search_fields = Page.search_fields + [
+        index.SearchField('intro'),
+        index.SearchField('body'),
+    ]
+
+    class Meta:
+        verbose_name = "{{titleCase baseName}}"

package/generators/wagtail-page/templates/page_template.html.hbs

@@ -0,0 +1,14 @@
+
+{% extends "base.html" %}
+{% load wagtailcore_tags %}
+
+{% block content %}
+    <h1>\{{ page.title }}</h1>
+    
+    <div class="intro">\{{ page.intro|richtext }}</div>
+
+    \{{ page.body|richtext }}
+{% endblock %}
+
+<!-- CLASS = {{pascalCase name}} START AI_GENERATED_PAGE_TEMPLATE -->
+<!-- CLASS = {{pascalCase name}} END AI_GENERATED_PAGE_TEMPLATE -->

package/generators/wagtail-page/templates/snippet_model.py.hbs

@@ -0,0 +1,24 @@
+
+@register_snippet
+class {{pascalCase name}}(models.Model):
+
+    """
+    {{pascalCase name}} snippet.
+    """
+    text = models.CharField(max_length=255)
+
+    panels = [
+        FieldPanel('text'),
+    ]
+    # <!-- CLASS = {{pascalCase name}} START AI_GENERATED_SNIPPET -->
+    # <!-- CLASS = {{pascalCase name}} END AI_GENERATED_SNIPPET -->
+
+    def __str__(self):
+        return self.text
+
+    def save(self, *args, **kwargs):
+        super().save(*args, **kwargs)
+
+    class Meta:
+        verbose_name = "{{sentenceCase name}}"
+        verbose_name_plural = "{{sentenceCase name}}s"

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "kalo-cli",
+  "version": "0.1.0",
+  "description": "Générateur de code structuré et uniforme pour Django et Wagtail",
+  "bin": {
+    "kalo": "./bin/kalo.ts"
+  },
+  "type": "module",
+  "scripts": {
+    "kalo": "bun bin/kalo.ts",
+    "doc": "bun run --port 3333 docs-site/index.html"
+  },
+  "keywords": [
+    "django",
+    "wagtail",
+    "generator",
+    "plop",
+    "cli",
+    "bun"
+  ],
+  "files": [
+    "bin",
+    "generators",
+    "utils",
+    "plopfile.ts",
+    "tsconfig.json"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@types/react": "^19.2.9",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "inquirer-autocomplete-prompt": "^3.0.1",
+    "minimist": "^1.2.8",
+    "plop": "^4.0.5",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "react-syntax-highlighter": "^16.1.0",
+    "serve": "^14.2.5",
+    "tsx": "^4.21.0"
+  }
+}

package/plopfile.ts

@@ -0,0 +1,26 @@
+import { NodePlopAPI } from 'plop';
+import autocompletePrompt from 'inquirer-autocomplete-prompt';
+import registerGenerators from './generators/main';
+
+/**
+ * Primary Plopfile entry point.
+ * Registers all generators and helpers.
+ *
+ * @param {NodePlopAPI} plop - The Plop API instance.
+ */
+export default function (plop: NodePlopAPI) {
+  // Register Prompts
+  plop.setPrompt('autocomplete', autocompletePrompt);
+
+  // Global Helpers
+    plop.setHelper('upperCase', (txt) => txt.toUpperCase());
+    plop.setHelper('snakeCase', (txt) => {
+        return txt && txt.match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
+            ?.map(x => x.toLowerCase())
+            .join('_');
+    });
+
+  // --- Register Generators ---
+  // The 'main' generator module now handles registering 'main' and 'help' generators.
+  registerGenerators(plop);
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}