create-sammi-next 0.0.1

package/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import './dist/index.js'

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "create-sammi-next",
+    "version": "0.0.1",
+    "type": "module",
+    "license": "MIT",
+    "author": {
+        "name": "Benjas333",
+        "url": "https://github.com/Benjas333"
+    },
+    "bin": {
+        "create-sammi-next": "index.js",
+        "csn": "index.js"
+    },
+    "files": [
+        "index.js",
+        "template-*",
+        "dist"
+    ],
+    "scripts": {
+        "dev": "tsdown --watch",
+        "build": "tsdown",
+        "typecheck": "tsc",
+        "prepublishOnly": "bun run build"
+    },
+    "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Benjas333/SAMMI-Next.git",
+        "directory": "packages/create-sammi-next"
+    },
+    "bugs": {
+        "url": "https://github.com/Benjas333/SAMMI-Next/issues"
+    },
+    "homepage": "https://github.com/Benjas333/SAMMI-Next/tree/master/packages/create_sammi-next#readme",
+    "devDependencies": {
+        "@clack/prompts": "^0.11.0",
+        "@types/node": "^25.0.9",
+        "mri": "^1.2.0",
+        "picocolors": "^1.1.1",
+        "tsdown": "^0.20.0-beta.3"
+    }
+}

package/template-minimal-js/README.md

@@ -0,0 +1,15 @@
+# {{EXTENSION_NAME}}
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run build
+```
+
+This project was created using create-sammi-next v{{CREATE_VERSION}}. [SAMMI Next](https://github.com/Benjas333/sammi-next) is a fast all-in-one SAMMI extension builder for SAMMI Bridge.

package/template-minimal-js/_gitignore

@@ -0,0 +1 @@
+node_modules

package/template-minimal-js/eslint.config.mjs

@@ -0,0 +1,76 @@
+import js from '@eslint/js';
+import { defineConfig, globalIgnores } from 'eslint/config';
+import pluginImport from 'eslint-plugin-import';
+import sdl from '@microsoft/eslint-plugin-sdl';
+import globals from "globals";
+import sammiNext from 'eslint-plugin-sammi-next';
+import extensionConfig from './sammi.config.js';
+
+export default defineConfig([
+    {
+        name: "main",
+        languageOptions: {
+            globals: {
+                ...globals.browser,
+                'SAMMI': true,
+                'sammiclient': true,
+                'SAMMIExtensions': true,
+            }
+        }
+    },
+    {
+        name: "sammi next entry script",
+        files: [extensionConfig.entry],
+        extends: [
+            sammiNext.configs.requiredEntry,
+        ]
+    },
+    {
+        name: "javascript files",
+        files: ["**/*.{js,mjs,cjs}"],
+        extends: [
+            js.configs.recommended,
+        ],
+    },
+    {
+        name: "general rules",
+        rules: {
+            'no-unused-vars': [
+                'error',
+                { varsIgnorePattern: '^[A-Z_]' }
+            ],
+            "@typescript-eslint/no-explicit-any": [
+                "warn",
+                { fixToUnknown: true },
+            ],
+        },
+    },
+    {
+        name: "import rules",
+        plugins: {
+            import: pluginImport
+        },
+        rules: {
+            'import/no-nodejs-modules': 'error',
+            'import/no-deprecated': 'error',
+            'import/no-extraneous-dependencies': 'error',
+            'import/export': 'error',
+        },
+    },
+    {
+        name: "@microsoft/sdl rules",
+        plugins: {
+            "@microsoft/sdl": sdl
+        },
+        rules: {
+            "@microsoft/sdl/no-document-write": "warn",
+            "@microsoft/sdl/no-inner-html": "warn",
+        },
+    },
+    globalIgnores([
+        "node_modules",
+        "dist",
+        "eslint.config.*",
+        "sammi.config.*",
+    ])
+]);

package/template-minimal-js/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "template-vanilla-js",
+    "devDependencies": {
+        "@eslint/js": "^9.39.2",
+        "@microsoft/eslint-plugin-sdl": "^1.1.0",
+        "eslint": "^9.39.2",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-sammi-next": "^1.0.0",
+        "globals": "^17.0.0"
+    },
+    "scripts": {
+        "dev": "sammi-next dev",
+        "build": "sammi-next",
+        "lint": "eslint ."
+    },
+    "type": "module",
+    "dependencies": {
+        "sammi-next": "^1.5.0"
+    }
+}

package/template-minimal-js/sammi.config.js

@@ -0,0 +1,9 @@
+import { defineConfig } from 'sammi-next/config'
+
+export default defineConfig({
+    id: "{{EXTENSION_ID}}",
+    name: "{{EXTENSION_NAME}}",
+    info: "",
+    version: "0.0.1",
+    entry: "src/script.js",
+});

package/template-minimal-js/src/script.js

@@ -0,0 +1,5 @@
+/// <reference types="sammi-next" />
+
+export default () => {
+    console.log("Hello world!");
+};

package/template-minimal-ts/README.md

@@ -0,0 +1,15 @@
+# {{EXTENSION_NAME}}
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run build
+```
+
+This project was created using create-sammi-next v{{CREATE_VERSION}}. [SAMMI Next](https://github.com/Benjas333/sammi-next) is a fast all-in-one SAMMI extension builder for SAMMI Bridge.

package/template-minimal-ts/_gitignore

@@ -0,0 +1 @@
+node_modules

package/template-minimal-ts/eslint.config.mjs

@@ -0,0 +1,88 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import { defineConfig, globalIgnores } from 'eslint/config';
+import pluginImport from 'eslint-plugin-import';
+import sdl from '@microsoft/eslint-plugin-sdl';
+import sammiNext from 'eslint-plugin-sammi-next';
+import extensionConfig from './sammi.config.ts'
+
+export default defineConfig([
+    js.configs.recommended,
+    {
+        name: "main",
+        languageOptions: {
+            parserOptions: {
+                // projectService: true,
+                projectService: {
+                    allowDefaultProject: ['eslint.config.*'],
+                    defaultProject: "tsconfig.json",
+                },
+                tsconfigRootDir: import.meta.dirname,
+                sourceType: 'module',
+            },
+        },
+    },
+    {
+        name: "sammi next entry script",
+        files: [extensionConfig.entry],
+        extends: [
+            sammiNext.configs.requiredEntry,
+        ]
+    },
+    {
+        name: "javascript files",
+        files: ["**/*.{js,mjs,cjs}"],
+        extends: [
+            tseslint.configs.recommended,
+        ],
+    },
+    {
+        name: "typescript files",
+        files: ["**/*.{ts,mts,cts}"],
+        extends: [
+            tseslint.configs.stylistic,
+            tseslint.configs.recommendedTypeChecked
+        ],
+    },
+    {
+        name: "general rules",
+        rules: {
+            'no-unused-vars': [
+                'error',
+                { varsIgnorePattern: '^[A-Z_]' }
+            ],
+            "@typescript-eslint/no-explicit-any": [
+                "warn",
+                { fixToUnknown: true },
+            ],
+        },
+    },
+    {
+        name: "import rules",
+        plugins: {
+            import: pluginImport
+        },
+        rules: {
+            'import/no-nodejs-modules': 'error',
+            'import/no-deprecated': 'error',
+            'import/no-extraneous-dependencies': 'error',
+            'import/export': 'error',
+        },
+    },
+    {
+        name: "@microsoft/sdl rules",
+        plugins: {
+            "@microsoft/sdl": sdl
+        },
+        rules: {
+            "@microsoft/sdl/no-document-write": "warn",
+            "@microsoft/sdl/no-inner-html": "warn",
+        },
+    },
+    globalIgnores([
+        "node_modules",
+        "dist",
+        "eslint.config.*",
+        "sammi.config.*",
+    ])
+]);

package/template-minimal-ts/package.json

@@ -0,0 +1,21 @@
+{
+    "name": "template-vanilla-ts",
+    "devDependencies": {
+        "@eslint/js": "^9.39.2",
+        "@microsoft/eslint-plugin-sdl": "^1.1.0",
+        "eslint": "^9.39.2",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-sammi-next": "^1.0.0",
+        "typescript": "^5",
+        "typescript-eslint": "^8.53.0"
+    },
+    "scripts": {
+        "dev": "sammi-next dev",
+        "build": "sammi-next",
+        "lint": "eslint ."
+    },
+    "type": "module",
+    "dependencies": {
+        "sammi-next": "^1.5.0"
+    }
+}

package/template-minimal-ts/sammi.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'sammi-next/config'
+
+export default defineConfig({
+    id: "{{EXTENSION_ID}}",
+    name: "{{EXTENSION_NAME}}",
+    info: "",
+    version: "0.0.1",
+    entry: "src/script.ts",
+});

package/template-minimal-ts/src/script.ts

@@ -0,0 +1,5 @@
+/// <reference types="sammi-next" />
+
+export default () => {
+    console.log("Hello world!");
+};

package/template-minimal-ts/tsconfig.json

@@ -0,0 +1,26 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "lib": ["DOM", "DOM.Iterable", "ESNext"],
+
+        "module": "preserve",
+        "moduleDetection": "force",
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "esModuleInterop": true,
+
+        "outDir": "./dist",
+        "rootDir": ".",
+        "sourceMap": true,
+
+        "jsx": "react-jsx",
+        "strict": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "allowJs": true,
+        // "noEmit": true,
+        "declaration": true,
+        "emitDeclarationOnly": true
+    },
+    "include": ["src/**/*"]
+}

package/template-sample-js/README.md

@@ -0,0 +1,15 @@
+# {{EXTENSION_NAME}}
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run build
+```
+
+This project was created using create-sammi-next v{{CREATE_VERSION}}. [SAMMI Next](https://github.com/Benjas333/sammi-next) is a fast all-in-one SAMMI extension builder for SAMMI Bridge.

package/template-sample-js/_gitignore

@@ -0,0 +1 @@
+node_modules

package/template-sample-js/eslint.config.mjs

@@ -0,0 +1,76 @@
+import js from '@eslint/js';
+import { defineConfig, globalIgnores } from 'eslint/config';
+import pluginImport from 'eslint-plugin-import';
+import sdl from '@microsoft/eslint-plugin-sdl';
+import globals from "globals";
+import sammiNext from 'eslint-plugin-sammi-next';
+import extensionConfig from './sammi.config.js';
+
+export default defineConfig([
+    {
+        name: "main",
+        languageOptions: {
+            globals: {
+                ...globals.browser,
+                'SAMMI': true,
+                'sammiclient': true,
+                'SAMMIExtensions': true,
+            }
+        }
+    },
+    {
+        name: "sammi next entry script",
+        files: [extensionConfig.entry],
+        extends: [
+            sammiNext.configs.requiredEntry,
+        ]
+    },
+    {
+        name: "javascript files",
+        files: ["**/*.{js,mjs,cjs}"],
+        extends: [
+            js.configs.recommended,
+        ],
+    },
+    {
+        name: "general rules",
+        rules: {
+            'no-unused-vars': [
+                'error',
+                { varsIgnorePattern: '^[A-Z_]' }
+            ],
+            "@typescript-eslint/no-explicit-any": [
+                "warn",
+                { fixToUnknown: true },
+            ],
+        },
+    },
+    {
+        name: "import rules",
+        plugins: {
+            import: pluginImport
+        },
+        rules: {
+            'import/no-nodejs-modules': 'error',
+            'import/no-deprecated': 'error',
+            'import/no-extraneous-dependencies': 'error',
+            'import/export': 'error',
+        },
+    },
+    {
+        name: "@microsoft/sdl rules",
+        plugins: {
+            "@microsoft/sdl": sdl
+        },
+        rules: {
+            "@microsoft/sdl/no-document-write": "warn",
+            "@microsoft/sdl/no-inner-html": "warn",
+        },
+    },
+    globalIgnores([
+        "node_modules",
+        "dist",
+        "eslint.config.*",
+        "sammi.config.*",
+    ])
+]);

package/template-sample-js/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "template-sample-js",
+    "devDependencies": {
+        "@eslint/js": "^9.39.2",
+        "@microsoft/eslint-plugin-sdl": "^1.1.0",
+        "eslint": "^9.39.2",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-sammi-next": "^1.0.0",
+        "globals": "^17.0.0"
+    },
+    "scripts": {
+        "dev": "sammi-next dev",
+        "build": "sammi-next",
+        "lint": "eslint ."
+    },
+    "type": "module",
+    "dependencies": {
+        "sammi-next": "^1.5.0"
+    }
+}

package/template-sample-js/sammi.config.js

@@ -0,0 +1,16 @@
+import { defineConfig } from 'sammi-next/config'
+
+export default defineConfig({
+    id: "{{EXTENSION_ID}}",
+    name: "{{EXTENSION_NAME}}",
+    info: "An example of an extension using SAMMI Next",
+    version: "0.0.1",
+    entry: "src/script.js",
+    external: "src/external.html",
+    over: "src/over.json",
+    out: {
+        dir: "dist",
+        js: "extension.js",
+        sef: "extension.sef",
+    },
+});

package/template-sample-js/src/external.html

@@ -0,0 +1,47 @@
+<!--
+ [insert_external]
+
+ ### Original documentation from https://sammi.solutions/extensions/build
+ This section appears inside the extension’s tab in Bridge, and it provides a visual interface for the extension if needed. It’s written in HTML and CSS.
+  -->
+<h1 id="title"></h1>
+<!-- You can access your exports through the `SAMMIExtensions` namespace -->
+<button onclick="SAMMIExtensions['{{EXTENSION_ID}}'].welcome()">Execute welcome()</button>
+<div class="calculator">
+    <h4>Multiply numbers</h4>
+    <span>
+        <span>Num 1:</span>
+        <input type="number" id="number-a" value="2">
+    </span>
+    <span>
+        <span>Num 2:</span>
+        <input type="number" id="number-b" value="3">
+    </span>
+    <span>
+        <button onclick="SAMMIExtensions['{{EXTENSION_ID}}'].multiplyButton()">Execute multiply()</button>
+        <span>Result:</span>
+        <span class="result-box"><b id="result"></b></span>
+    </span>
+</div>
+
+<style>
+    /* The id of the div that wraps your [insert_external] section follows the format: {extension_id}-external */
+    #{{EXTENSION_ID}}-external {
+        .calculator {
+            display: flex;
+            flex-direction: column;
+            max-width: fit-content;
+            padding: 10px;
+            border-radius: 10px;
+            color: black;
+            background-color: #acacac;
+
+            .result-box {
+                padding: 5px;
+                border-radius: 10px;
+                color: white;
+                background-color: #585858;
+            }
+        }
+    }
+</style>

package/template-sample-js/src/over.json

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

package/template-sample-js/src/script.js

@@ -0,0 +1,64 @@
+/**
+ * [insert_script]
+ * In this section, you’re encouraged to write your own TypeScript code.
+*
+ * ### Original documentation from https://sammi.solutions/extensions/build
+ * We recommend having one main function that runs as soon as SAMMI connects to Bridge, and which you call from [insert_command] section.
+ * Inside this function, you can set up listeners for extension commands coming from SAMMI, e.g. when a user actually runs a button containing your extension command you defined in [insert_command] section.
+ *
+ * Learn more about Listening to Extension Commands in the SAMMI Bridge documentation.
+ *
+ * SAMMI Bridge provides premade helper functions for you to use, such as retrieving variables, setting variables, triggering buttons and more. You can find all the helper functions in the SAMMI Bridge documentation
+ */
+import { getExternalSection, initExtension, insertCommandSection } from "sammi-next";
+// <reference types="sammi-next" />
+// sammi-next globals are automatically imported when importing anything from sammi-next library.
+import { multiply } from "./utils/utils";
+import extensionConfig from '../sammi.config';
+
+const CONFIG = initExtension(extensionConfig);
+
+// Use getExternalSection() to retrieve your [insert_external] section.
+const EXTERNAL = getExternalSection(CONFIG.id);
+
+const title = EXTERNAL.querySelector('#title');
+
+title.innerText = `${CONFIG.name} - v${CONFIG.version}`;
+
+const inputA = EXTERNAL.querySelector("#number-a");
+const inputB = EXTERNAL.querySelector("#number-b");
+const resultEl = EXTERNAL.querySelector('#result');
+
+// The default export is your [insert_command] section. It must be a function.
+export default insertCommandSection(() => {
+    /**
+     * [insert_command]
+     *
+     * ### Original documentation from https://sammi.solutions/extensions/build
+     * In this section, you can define Extension Commands.
+     * These commands will be available to users in SAMMI Core when they install your extension.
+     * You can define multiple commands in this section. Refer to the SAMMI Bridge documentation for Extension Command details.
+     * In this section, you can also automatically call your main extension function that should run as soon as SAMMI connects to Bridge.
+     */
+    welcome();
+
+    SAMMI.extCommand("Extension Sample Command", 3355443, 52).catch(e => console.error(e));
+    sammiclient.on("Extension Sample Command", () => {
+        const handler = async () => {
+            await SAMMI.notification('Command Sample');
+        };
+        handler().catch((e) => console.error(e));
+    });
+});
+
+const message = `Hello world from ${CONFIG.name}!`;
+
+// Export the functions you want to access from your [insert_external] section.
+export function welcome() {
+    console.log(message);
+}
+
+export function multiplyButton() {
+    const result = multiply(parseInt(inputA.value), parseInt(inputB.value));
+    resultEl.innerText = result.toString();
+}

package/template-sample-js/src/utils/utils.js

@@ -0,0 +1,3 @@
+export function multiply(a, b) {
+    return a * b;
+}

package/template-sample-ts/README.md

@@ -0,0 +1,15 @@
+# {{EXTENSION_NAME}}
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run build
+```
+
+This project was created using create-sammi-next v{{CREATE_VERSION}}. [SAMMI Next](https://github.com/Benjas333/sammi-next) is a fast all-in-one SAMMI extension builder for SAMMI Bridge.

package/template-sample-ts/_gitignore

@@ -0,0 +1 @@
+node_modules