extension 4.0.30 → 4.0.32

package/dist/cli.cjs

@@ -6185,7 +6185,7 @@ var __webpack_modules__ = {
         const DEFAULT_SAMPLE_RATE = Number(process.env.EXTENSION_TELEMETRY_SAMPLE_RATE || 0.2);
         const DEFAULT_MAX_EVENTS = Number(process.env.EXTENSION_TELEMETRY_MAX_EVENTS || 3);
         const DEFAULT_DEBOUNCE_MS = Number(process.env.EXTENSION_TELEMETRY_DEBOUNCE_MS || 60000);
-        const DEFAULT_TIMEOUT_MS = Number(process.env.EXTENSION_TELEMETRY_TIMEOUT_MS || 300);
+        const DEFAULT_TIMEOUT_MS = Number(process.env.EXTENSION_TELEMETRY_TIMEOUT_MS || 2000);
         const DEFAULT_AUDIT_MAX_BYTES = 1048576;
         function auditMaxBytes() {
             const raw = Number(process.env.EXTENSION_TELEMETRY_AUDIT_MAX_BYTES);
@@ -6762,9 +6762,68 @@ var __webpack_modules__ = {
             return await import(bridgeSpecifier);
         }
         var messaging = __webpack_require__("./helpers/messaging.ts");
+        const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
+        const TEMPLATE_CORPUS_REF = 'f7f4e6efb56a7e5ae08d58dbff3972d94af7d021';
+        const TEMPLATE_CORPUS_SLUGS = [
+            'action',
+            'action-locales',
+            'ai-chatgpt',
+            'ai-claude',
+            'ai-gemini',
+            'ai-perplexity',
+            'content',
+            'content-css-modules',
+            'content-custom-font',
+            'content-env',
+            'content-less',
+            'content-less-modules',
+            'content-main-world',
+            'content-multi-one-entry',
+            'content-multi-three-entries',
+            'content-preact',
+            'content-react',
+            'content-sass',
+            'content-sass-modules',
+            'content-svelte',
+            "content-typescript",
+            'content-vue',
+            'init',
+            "javascript",
+            'new',
+            'new-browser-flags',
+            'new-config-eslint',
+            'new-config-prettier',
+            'new-config-stylelint',
+            'new-crypto',
+            'new-env',
+            'new-less',
+            'new-preact',
+            'new-react',
+            'new-react-router',
+            'new-sass',
+            'new-svelte',
+            "new-typescript",
+            'new-vue',
+            'playwright',
+            'preact',
+            'react',
+            'sidebar',
+            'sidebar-antd',
+            'sidebar-monorepo-turborepo',
+            'sidebar-shadcn',
+            'special-folders-pages',
+            "special-folders-scripts",
+            'svelte',
+            'transformers-js',
+            "typescript",
+            'vue'
+        ];
         const DEFAULT_TEMPLATE = "javascript";
-        const TEMPLATE_CATALOG_URL = 'https://github.com/extension-js/examples/tree/main/examples';
-        const TEMPLATE_GROUPS = [
+        const BUNDLED_TEMPLATES = [
+            "javascript"
+        ];
+        const TEMPLATE_CATALOG_URL = `https://github.com/${TEMPLATE_CORPUS_REPO}/tree/${TEMPLATE_CORPUS_REF}/examples`;
+        const CURATED_GROUPS = [
             {
                 title: 'Starters',
                 summary: 'a bare manifest, or one language or framework with sidebar UI',
@@ -6854,6 +6913,33 @@ var __webpack_modules__ = {
                 ]
             }
         ];
+        const UNCURATED_GROUP_TITLE = 'More templates';
+        function buildTemplateGroups() {
+            const published = new Set(TEMPLATE_CORPUS_SLUGS);
+            const claimed = new Set();
+            const groups = [];
+            for (const group of CURATED_GROUPS){
+                const templates = group.templates.filter((name)=>{
+                    if (!published.has(name) || claimed.has(name)) return false;
+                    claimed.add(name);
+                    return true;
+                });
+                if (templates.length) groups.push({
+                    ...group,
+                    templates
+                });
+            }
+            const uncurated = TEMPLATE_CORPUS_SLUGS.filter((name)=>!claimed.has(name));
+            if (uncurated.length) groups.push({
+                title: UNCURATED_GROUP_TITLE,
+                summary: 'published in the catalog, not yet grouped',
+                templates: [
+                    ...uncurated
+                ]
+            });
+            return groups;
+        }
+        const TEMPLATE_GROUPS = buildTemplateGroups();
         const TEMPLATE_ALIASES = [];
         function listTemplates() {
             return TEMPLATE_GROUPS.flatMap((group)=>group.templates);
@@ -6897,14 +6983,19 @@ var __webpack_modules__ = {
         function renderCreateTemplateHelp() {
             const total = listTemplates().length;
             const dim = (text)=>external_pintor_default().gray(text);
+            const defaultIsBundled = BUNDLED_TEMPLATES.includes(DEFAULT_TEMPLATE);
             return [
                 '',
                 external_pintor_default().underline(external_pintor_default().blue(`Templates (${total})`)),
                 renderTemplateList(),
                 '',
                 `  ${external_pintor_default().green('Default')}`,
-                `    ${external_pintor_default().blue(DEFAULT_TEMPLATE)} ${dim('is used when --template is omitted. It ships inside the CLI,')}`,
-                dim('    so it scaffolds with no network call.'),
+                `    ${external_pintor_default().blue(DEFAULT_TEMPLATE)} ${dim('is used when --template is omitted.')}`,
+                ...defaultIsBundled ? [
+                    dim('    It ships inside the CLI, so it scaffolds with no network.')
+                ] : [
+                    dim('    It downloads the catalog archive like every other name.')
+                ],
                 '',
                 `  ${external_pintor_default().green('Everything else')}`,
                 dim('    downloads the catalog archive at create time, so it needs the'),
@@ -7330,7 +7421,7 @@ Environment variables
 
 Available templates
 ${TEMPLATE_GROUPS.map((group)=>`- ${external_pintor_default().green(group.title)} ${messages_arg(`(${group.summary})`)}: ${group.templates.map((template)=>messages_code(template)).join(', ')}`).join('\n')}${TEMPLATE_ALIASES.length > 0 ? `\n- ${external_pintor_default().green('Alias')}: ${TEMPLATE_ALIASES.map((alias)=>`${messages_code(alias.name)} ${messages_arg(alias.note)}`).join(', ')}` : ''}
-- ${messages_code(DEFAULT_TEMPLATE)} is the default when ${messages_code('--template')} is omitted. It ships inside the CLI and needs no network.
+- ${messages_code(DEFAULT_TEMPLATE)} is the default when ${messages_code('--template')} is omitted.${BUNDLED_TEMPLATES.includes(DEFAULT_TEMPLATE) ? ' It ships inside the CLI and needs no network.' : ''}
 - Every other name is downloaded from ${messages_code(TEMPLATE_CATALOG_URL)} at create time. A GitHub or ZIP URL works in place of a name.
 - A name that is not on this list fails with ${messages_code('TemplateNotFoundError')}. Run ${messages_code('extension create --help')} for the same list.
 
@@ -7467,9 +7558,13 @@ Cross-browser compatibility
                 templates: {
                     default: DEFAULT_TEMPLATE,
                     bundled: [
-                        DEFAULT_TEMPLATE
+                        ...BUNDLED_TEMPLATES
                     ],
                     catalogUrl: TEMPLATE_CATALOG_URL,
+                    corpus: {
+                        repo: TEMPLATE_CORPUS_REPO,
+                        ref: TEMPLATE_CORPUS_REF
+                    },
                     names: listTemplates(),
                     groups: TEMPLATE_GROUPS.map((group)=>({
                             title: group.title,
@@ -7485,10 +7580,10 @@ Cross-browser compatibility
                     },
                     notes: [
                         `extension create <name> with no --template scaffolds ${DEFAULT_TEMPLATE}`,
-                        `${DEFAULT_TEMPLATE} is bundled with the CLI and scaffolds offline. Every other name downloads the examples archive at create time`,
+                        'every name in bundled[] ships inside the CLI package and scaffolds offline. Every other name downloads the examples archive at create time',
                         'a GitHub URL or a ZIP URL is accepted in place of a catalog name',
                         'a name outside names[] fails with TemplateNotFoundError and creates nothing',
-                        'this list ships with the CLI, so it is the list this CLI version can scaffold, not necessarily the current contents of the catalog repository'
+                        `names[] is generated from ${TEMPLATE_CORPUS_REPO} at corpus.ref, the exact commit this CLI version downloads, so it is what this version can scaffold and not the current contents of the catalog repository`
                     ]
                 },
                 capabilities: {
@@ -7676,6 +7771,7 @@ Cross-browser compatibility
                 const browser = options.browser || 'chromium';
                 const format = resolveFormat(options);
                 const matches = makeFilter(options);
+                if (options.signalsOnly) console.error("extension logs --signals-only: no signals emitter ships in this build, so dev sessions record no dx.signal events and this filter will print nothing.");
                 if (options.follow) return void await followLogs(projectPath, browser, format, matches);
                 const file = logsFilePath(projectPath, browser);
                 if (!external_node_fs_default().existsSync(file)) {

package/dist/extension/helpers/messages.d.ts

@@ -225,6 +225,10 @@ export type ProgramAIHelpJSON = {
         default: string;
         bundled: string[];
         catalogUrl: string;
+        corpus: {
+            repo: string;
+            ref: string;
+        };
         names: string[];
         groups: Array<{
             title: string;

package/dist/extension/helpers/template-catalog.d.ts

@@ -1,5 +1,6 @@
 export declare const DEFAULT_TEMPLATE = "javascript";
-export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/main/examples";
+export declare const BUNDLED_TEMPLATES: readonly string[];
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/f7f4e6efb56a7e5ae08d58dbff3972d94af7d021/examples";
 export interface TemplateGroup {
     title: string;
     summary: string;
@@ -10,6 +11,8 @@ export interface TemplateAlias {
     resolvesTo: string;
     note: string;
 }
+export declare const CURATED_GROUPS: readonly TemplateGroup[];
+export declare const UNCURATED_GROUP_TITLE = "More templates";
 export declare const TEMPLATE_GROUPS: readonly TemplateGroup[];
 export declare const TEMPLATE_ALIASES: readonly TemplateAlias[];
 export declare function listTemplates(): string[];

package/dist/extension/helpers/template-corpus.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const TEMPLATE_CORPUS_REPO = "extension-js/examples";
+export declare const TEMPLATE_CORPUS_REF = "f7f4e6efb56a7e5ae08d58dbff3972d94af7d021";
+export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.30",
+  "version": "4.0.32",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,9 +106,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.0.30",
-    "extension-develop": "4.0.30",
-    "extension-install": "4.0.30",
+    "extension-create": "4.0.32",
+    "extension-develop": "4.0.32",
+    "extension-install": "4.0.32",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",

package/types/index.d.ts

@@ -5,7 +5,7 @@
 
 declare global {
   // Align types with Extension.js runtime: we provide the browser global via
-  // webextension-polyfill in Chromium, and it's natively available in Firefox.
+  // webextension-polyfill in Chromium; Firefox and Safari ship it natively.
   const browser: typeof import('webextension-polyfill')
 
   type ExtensionBrowser =