create-qs 0.0.0 → 0.8.23

package/template/default/eslint.config.js

@@ -0,0 +1,137 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import typescript from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+import stylistic from '@stylistic/eslint-plugin';
+
+export default [
+    js.configs.recommended,
+    {
+        ignores: [
+            '**/node_modules/**',
+            '**/iconfont.js',
+            '.git/**',
+
+            // Written by `pnpm install` and `pnpm qs sources`, not project code
+            '.agents/**',
+            '.claude/**',
+            '.quicksilver/**',
+
+            'build/**',
+            'local/**',
+
+            'modules/*/*/build/**',
+            'modules/*/*/dist/**',
+            'modules/*/*/static/**',
+            'run/*/local/**',
+            'run/*/dist/**',
+            'run/*/static/**',
+        ],
+    },
+
+    // ------------------------------------------------------------------------
+    // Global languageOptions & rules
+    // ------------------------------------------------------------------------
+
+    {
+        plugins: {
+            '@stylistic': stylistic,
+        },
+        languageOptions: {
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            globals: {
+                ...globals.browser,
+                ...globals.node,
+            },
+        },
+        rules: {
+            // --- General syntax rules ---
+            'no-console': 'warn',
+            'no-redeclare': 'off',
+            'no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+
+            // --- Stylistic rules (alphabetical order) ---
+            '@stylistic/array-bracket-newline': ['error', 'consistent'],
+            '@stylistic/array-bracket-spacing': ['error', 'never'],
+            '@stylistic/arrow-parens': ['error', 'as-needed'],
+            '@stylistic/block-spacing': ['error', 'always'],
+            '@stylistic/brace-style': ['error', '1tbs', { allowSingleLine: true }],
+            '@stylistic/comma-dangle': ['error', 'always-multiline'],
+            '@stylistic/comma-spacing': ['error', { before: false, after: true }],
+            '@stylistic/dot-location': ['error', 'property'],
+            '@stylistic/eol-last': ['error', 'always'],
+            '@stylistic/function-call-spacing': ['error', 'never'],
+            '@stylistic/function-paren-newline': ['error', 'consistent'],
+            '@stylistic/indent': ['error', 4, { SwitchCase: 1 }],
+            '@stylistic/key-spacing': ['error', { beforeColon: false, afterColon: true }],
+            '@stylistic/keyword-spacing': ['error', { before: true, after: true }],
+            '@stylistic/max-len': ['error', {
+                code: 120,
+                tabWidth: 4,
+                ignoreUrls: true,
+                ignoreComments: false,
+                ignoreRegExpLiterals: true,
+                ignoreStrings: true,
+                ignoreTemplateLiterals: true,
+            }],
+            '@stylistic/new-parens': 'error',
+            '@stylistic/no-mixed-spaces-and-tabs': 'error',
+            '@stylistic/no-multiple-empty-lines': ['error', { max: 1 }],
+            '@stylistic/no-tabs': 'error',
+            '@stylistic/no-trailing-spaces': 'error',
+            '@stylistic/object-curly-spacing': ['error', 'always'],
+            '@stylistic/object-property-newline': ['error', { allowAllPropertiesOnSameLine: true }],
+            '@stylistic/one-var-declaration-per-line': ['error', 'always'],
+            '@stylistic/padded-blocks': ['error', 'never'],
+            '@stylistic/quotes': ['error', 'single', { 'avoidEscape': true }],
+            '@stylistic/semi': ['error', 'always'],
+            '@stylistic/space-before-function-paren': ['error', {
+                anonymous: 'never',
+                named: 'never',
+                asyncArrow: 'always',
+                catch: 'always',
+            }],
+            '@stylistic/space-in-parens': ['error', 'never'],
+            '@stylistic/space-infix-ops': 'error',
+            '@stylistic/spaced-comment': ['error', 'always', { markers: ['/'] }],
+        },
+    },
+
+    // ------------------------------------------------------------------------
+    // TypeScript
+    // ------------------------------------------------------------------------
+
+    {
+        files: ['**/*.{ts,tsx}'],
+        languageOptions: {
+            parser: typescriptParser,
+            // No `project`: none of the rules below needs type information. Enabling a rule that
+            // does (the *-type-checked sets) requires `projectService: true` here.
+            parserOptions: {
+                ecmaVersion: 'latest',
+                sourceType: 'module',
+            },
+        },
+        plugins: {
+            '@typescript-eslint': typescript,
+        },
+        rules: {
+            ...typescript.configs.recommended.rules,
+            'no-undef': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/no-redeclare': 'off',
+            '@typescript-eslint/no-empty-object-type': 'off',
+            '@typescript-eslint/ban-ts-comment': 'off',
+        },
+    },
+
+    // ------------------------------------------------------------------------
+    // JavaScript
+    // ------------------------------------------------------------------------
+
+    {
+        files: ['**/*.{js,jsx,mjs,cjs}'],
+        rules: {},
+    },
+];

package/template/default/gradle/repo.settings.gradle.kts

@@ -0,0 +1,90 @@
+// The repository that serves the Quicksilver Gradle plugin and the platform artifacts, and the login
+// for it. settings.gradle.kts applies this script. It sets up both the repository the plugin is
+// downloaded from and the repositories of every project, so the rules below are written only once.
+// Do not edit it: the address and the login come from the quicksilver.repo.* keys, and the comment
+// in gradle.properties says where each one belongs. See .quicksilver/manual/en-US/00-setup.md.
+
+// Read the keys with `providers.gradleProperty(...)`: `startParameter.projectProperties` only carries
+// `-P` arguments and would silently ignore every gradle.properties file. Values are trimmed because
+// gradle.properties keeps trailing spaces.
+fun property(key: String) = providers.gradleProperty(key).orNull?.trim()?.takeIf { it.isNotEmpty() }
+
+val userProperties = gradle.gradleUserHomeDir.resolve("gradle.properties")
+val repo = property("quicksilver.repo.url")
+    ?: throw GradleException("quicksilver.repo.url is not set. Set it in $userProperties for every"
+        + " project on this machine, or in this project's gradle.properties for everyone on the"
+        + " project. See .quicksilver/manual/en-US/00-setup.md")
+
+// The login is <prefix>.user and <prefix>.password. The prefix defaults to quicksilver.repo, so a
+// machine with one repository sets quicksilver.repo.user and quicksilver.repo.password. Naming another
+// prefix in quicksilver.repo.credentials lets projects on one machine log in to different repositories
+// with different accounts. An empty quicksilver.repo.credentials= turns the login off, for a project
+// pinned to a repository that allows anonymous reads.
+val credentialsSetting = providers.gradleProperty("quicksilver.repo.credentials").orNull?.trim()
+val loginOff = credentialsSetting == ""
+val namedPrefix = credentialsSetting?.takeIf { it.isNotEmpty() }
+val prefix = namedPrefix ?: "quicksilver.repo"
+
+// Every check below fails here on purpose. Without them the build goes on anonymously and ends with a
+// "plugin was not found" that never mentions credentials.
+//
+// The project's gradle.properties is committed, so the login never belongs there. Gradle merges it with
+// the user's file, so the project file is read on its own to tell them apart.
+val projectProperties = java.util.Properties()
+settingsDir.resolve("gradle.properties").takeIf { it.isFile }?.reader()?.use { projectProperties.load(it) }
+val committed = listOf("quicksilver.repo.user", "quicksilver.repo.password", "$prefix.user", "$prefix.password")
+    .distinct()
+    .filter { !projectProperties.getProperty(it).isNullOrBlank() }
+if (committed.isNotEmpty()) {
+    throw GradleException("${committed.joinToString(" and ")} must not be in this project's"
+        + " gradle.properties, which is committed. Put the login in $userProperties")
+}
+
+// A file: repository takes no login, and Gradle refuses one on it. An empty
+// quicksilver.repo.credentials= turns the login off as well.
+val loginSkipped = repo.startsWith("file:") || loginOff
+val repoUser = property("$prefix.user")
+val repoPassword = property("$prefix.password")
+val missing = listOfNotNull(
+    "$prefix.user".takeIf { repoUser == null },
+    "$prefix.password".takeIf { repoPassword == null },
+)
+// Neither half set means an anonymous repository, unless a prefix was named on purpose
+if (!loginSkipped && (missing.size == 1 || (namedPrefix != null && missing.isNotEmpty()))) {
+    val reason = if (namedPrefix != null) "quicksilver.repo.credentials is '$prefix', so" else "Half a login is set:"
+    throw GradleException("$reason $userProperties must set ${missing.joinToString(" and ")}")
+}
+val login = !loginSkipped && missing.isEmpty()
+
+fun RepositoryHandler.quicksilver() = maven {
+    url = uri(repo)
+    // A login over http:// travels in clear text. That is allowed on purpose, since intranet
+    // repositories are often plain http. The docs ask for https:// instead.
+    isAllowInsecureProtocol = repo.startsWith("http://")
+    if (login) {
+        credentials {
+            username = repoUser
+            password = repoPassword
+        }
+        // Send the login with every request. Without this, Gradle only sends it after a 401, and
+        // repositories that answer an anonymous request with 404 never get it.
+        authentication {
+            create<BasicAuthentication>("basic")
+        }
+    }
+}
+
+// Where the Quicksilver plugin is downloaded from
+pluginManagement.repositories {
+    quicksilver()
+    gradlePluginPortal()
+    mavenCentral()
+}
+
+// Where every project resolves the platform artifacts and third-party libraries from
+gradle.allprojects {
+    repositories {
+        quicksilver()
+        mavenCentral()
+    }
+}

package/template/default/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.7.1-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/template/default/gradle.properties

@@ -0,0 +1,15 @@
+kotlin.code.style=official
+
+# The Quicksilver platform version. The root Gradle plugin, and every com.qsrun
+# dependency declared without a version, resolve to it. `pnpm qs upgrade <version>` rewrites this
+# line together with catalogs.quicksilver in pnpm-workspace.yaml.
+quicksilver.version={{QUICKSILVER_VERSION}}
+
+# The Maven repository that serves the Quicksilver Gradle plugin and the platform artifacts, such as
+# https://nexus-server/repository/maven-public/. Ask whoever provides you with Quicksilver for it.
+# Set it in ~/.gradle/gradle.properties to cover every project on this machine (that file takes
+# precedence), or here to pin it for everyone on the project. The build stops at startup while
+# neither is set. A login, if the repository needs one, goes in ~/.gradle/gradle.properties only,
+# as quicksilver.repo.user and quicksilver.repo.password: this file is committed, and the build
+# stops if either key shows up here. See .quicksilver/manual/en-US/00-setup.md.
+quicksilver.repo.url=

package/template/default/gradlew

@@ -0,0 +1,248 @@
+#!/bin/sh
+
+#
+# Copyright © 2015 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

package/template/default/gradlew.bat

@@ -0,0 +1,93 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

package/template/default/modules/{{MODULE_DIRECTORY}}/api/build.gradle.kts

@@ -0,0 +1,8 @@
+plugins {
+    id("com.qsrun.quicksilver.gradle.module")
+}
+
+dependencies {
+    {{PLATFORM_API_DEPENDENCIES}}
+    testImplementation("com.qsrun:quicksilver-test-support")
+}

package/template/default/modules/{{MODULE_DIRECTORY}}/api/data/demo/README.md

@@ -0,0 +1,11 @@
+# Demo data
+
+This folder holds demo data, rows that exist only to show and test the product, such as sample customers and orders. Production installs do not need them.
+
+- Put the rows in `.jsons` files in this folder or in subfolders of it. Other files, such as this README, are skipped.
+- On a fresh install of the module, the files run after everything in `data/init/`, sorted by name level by level with each subfolder run where it sorts, and they can refer to rows written there.
+- Development and test profiles load demo data, as set by `quicksilver.datasource.auto-init.demo-data` in `run/api/config/application-dev.yaml`. On a production install the installer asks first, and does not load it by default.
+- A module that is already installed never loads demo data. Draft sync does not run these files either, so an existing database does not pick up files added or changed here. To load them, set `drop-first: true` for one start, then set it back to `false`. The rebuild clears the whole development database, including rows entered through the UI.
+- Do not copy demo rows into `data/upgrade/draft.jsons`. Upgrades never load demo data.
+
+The rules for data files are in section 10 of [`.agents/skills/qs-jsons/references/json-command.md`](../../../../../.agents/skills/qs-jsons/references/json-command.md), and in the developer manual at [`.quicksilver/manual/en-US/06-data.md`](../../../../../.quicksilver/manual/en-US/06-data.md). Both are written by `pnpm install`.

package/template/default/modules/{{MODULE_DIRECTORY}}/api/data/init/rows/menus.jsons

@@ -0,0 +1 @@
+{{MODULE_MENU}}

package/template/default/modules/{{MODULE_DIRECTORY}}/api/data/init/rows/misc.jsons

@@ -0,0 +1,15 @@
+// This file is the default place for the module's rows, and its first command is the module row
+// below. When one kind of rows grows into a topic of its own, move it to a file of its own in rows/,
+// named with a plural noun and with underscores between words. The usual names follow.
+//
+//   menus.jsons           menus
+//   roles.jsons           roles and grants
+//   dictionaries.jsons    dictionaries shared by several units
+//   texts.jsons           texts (ac.text)
+//   error_messages.jsons  error messages (ac.error_message)
+//   settings.jsons        setting groups and setting definitions
+//
+// pnpm qs new unit appends to menus.jsons and roles.jsons. The files in rows/ have no ordering
+// dependencies between them, and each row is written by one file only.
+
+{ $insert: 'ac.module', id: '{{MODULE_ID}}', name: '{{MODULE_DIRECTORY}}',		code: '{{MODULE_CODE}}', 	icon: 'quicksilver:module-work', {{MODULE_DEFAULT_MENU}}}

package/template/default/modules/{{MODULE_DIRECTORY}}/api/data/upgrade/draft.jsons

@@ -0,0 +1 @@
+// Upgrade draft. Write data changes here along with the matching init changes. pnpm qs data freeze renames it to a versioned upgrade file.

package/template/default/modules/{{MODULE_DIRECTORY}}/api/src/main/kotlin/{{API_PACKAGE}}/AutoConfiguration.kt

@@ -0,0 +1,25 @@
+package {{API_PACKAGE}}
+
+import com.qsrun.quicksilver.core.application.startup.QsExcludeFilter
+import jakarta.annotation.PostConstruct
+import org.slf4j.LoggerFactory
+import org.springframework.context.annotation.ComponentScan
+import org.springframework.context.annotation.ComponentScan.Filter
+import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.FilterType
+
+@Configuration
+@ComponentScan(
+    basePackages = ["{{API_PACKAGE}}"],
+    // QsExcludeFilter keeps @QsController / @QsService / @QsDao out of the regular bean scan —
+    // Quicksilver registers them itself. Without it they are scanned as plain beans and skipped.
+    excludeFilters = [Filter(type = FilterType.CUSTOM, classes = [QsExcludeFilter::class])],
+)
+class AutoConfiguration {
+    private val logger = LoggerFactory.getLogger(AutoConfiguration::class.java)
+
+    @PostConstruct
+    fun afterInit() {
+        logger.info("${AutoConfiguration::class.qualifiedName} is active, scanning package {{API_PACKAGE}}")
+    }
+}

package/template/default/modules/{{MODULE_DIRECTORY}}/api/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -0,0 +1 @@
+{{API_PACKAGE}}.AutoConfiguration