@blukavantui/community 0.0.0-stage → 1.0.1

package/package.json

@@ -1,6 +1,393 @@
 {
   "name": "@blukavantui/community",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "BluKavantUI Community: 55 components for Web and OutSystems; ten advanced components are Pro.",
+  "homepage": "https://blukavantui.blutekmedia.com/community",
+  "bugs": {
+    "url": "https://blutekmedia.com/contact"
+  },
+  "author": {
+    "name": "BluTek Media",
+    "url": "https://blutekmedia.com"
+  },
+  "keywords": [
+    "blukavantui",
+    "typescript",
+    "javascript",
+    "ui",
+    "components",
+    "outsystems",
+    "data-grid"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./grid-basic": {
+      "types": "./dist/grid-basic.d.ts",
+      "import": "./dist/grid-basic.js"
+    },
+    "./essentials": {
+      "types": "./dist/essentials.d.ts",
+      "import": "./dist/essentials.js"
+    },
+    "./theme": {
+      "types": "./dist/theme.d.ts",
+      "import": "./dist/theme.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./grid-basic.css": "./dist/grid-basic.css",
+    "./essentials.css": "./dist/essentials.css",
+    "./theme.css": "./dist/theme.css",
+    "./float-button": {
+      "types": "./dist/float-button.d.ts",
+      "import": "./dist/float-button.js"
+    },
+    "./float-button.css": "./dist/float-button.css",
+    "./breadcrumbs": {
+      "types": "./dist/breadcrumbs.d.ts",
+      "import": "./dist/breadcrumbs.js"
+    },
+    "./breadcrumbs.css": "./dist/breadcrumbs.css",
+    "./page-header": {
+      "types": "./dist/page-header.d.ts",
+      "import": "./dist/page-header.js"
+    },
+    "./page-header.css": "./dist/page-header.css",
+    "./pagination": {
+      "types": "./dist/pagination.d.ts",
+      "import": "./dist/pagination.js"
+    },
+    "./pagination.css": "./dist/pagination.css",
+    "./statistic": {
+      "types": "./dist/statistic.d.ts",
+      "import": "./dist/statistic.js"
+    },
+    "./statistic.css": "./dist/statistic.css",
+    "./timeline": {
+      "types": "./dist/timeline.d.ts",
+      "import": "./dist/timeline.js"
+    },
+    "./timeline.css": "./dist/timeline.css",
+    "./descriptions": {
+      "types": "./dist/descriptions.d.ts",
+      "import": "./dist/descriptions.js"
+    },
+    "./descriptions.css": "./dist/descriptions.css",
+    "./sidebar": {
+      "types": "./dist/sidebar.d.ts",
+      "import": "./dist/sidebar.js"
+    },
+    "./sidebar.css": "./dist/sidebar.css",
+    "./drawer": {
+      "types": "./dist/drawer.d.ts",
+      "import": "./dist/drawer.js"
+    },
+    "./drawer.css": "./dist/drawer.css",
+    "./chat": {
+      "types": "./dist/chat.d.ts",
+      "import": "./dist/chat.js"
+    },
+    "./chat.css": "./dist/chat.css",
+    "./chat-widget": {
+      "types": "./dist/chat-widget.d.ts",
+      "import": "./dist/chat-widget.js"
+    },
+    "./chat-widget.css": "./dist/chat-widget.css",
+    "./upload-manager": {
+      "types": "./dist/upload-manager.d.ts",
+      "import": "./dist/upload-manager.js"
+    },
+    "./upload-manager.css": "./dist/upload-manager.css",
+    "./transfer-list": {
+      "types": "./dist/transfer-list.d.ts",
+      "import": "./dist/transfer-list.js"
+    },
+    "./transfer-list.css": "./dist/transfer-list.css",
+    "./tree-select": {
+      "types": "./dist/tree-select.d.ts",
+      "import": "./dist/tree-select.js"
+    },
+    "./tree-select.css": "./dist/tree-select.css",
+    "./cascader": {
+      "types": "./dist/cascader.d.ts",
+      "import": "./dist/cascader.js"
+    },
+    "./cascader.css": "./dist/cascader.css",
+    "./dashboard-canvas": {
+      "types": "./dist/dashboard-canvas.d.ts",
+      "import": "./dist/dashboard-canvas.js"
+    },
+    "./dashboard-canvas.css": "./dist/dashboard-canvas.css",
+    "./dashboard-panel": {
+      "types": "./dist/dashboard-panel.d.ts",
+      "import": "./dist/dashboard-panel.js"
+    },
+    "./dashboard-panel.css": "./dist/dashboard-panel.css",
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./core.css": "./dist/core.css",
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.js"
+    },
+    "./layout.css": "./dist/layout.css",
+    "./inputs": {
+      "types": "./dist/inputs.d.ts",
+      "import": "./dist/inputs.js"
+    },
+    "./inputs.css": "./dist/inputs.css",
+    "./feedback": {
+      "types": "./dist/feedback.d.ts",
+      "import": "./dist/feedback.js"
+    },
+    "./feedback.css": "./dist/feedback.css",
+    "./data": {
+      "types": "./dist/data.d.ts",
+      "import": "./dist/data.js"
+    },
+    "./data.css": "./dist/data.css",
+    "./grid": {
+      "types": "./dist/grid.d.ts",
+      "import": "./dist/grid.js"
+    },
+    "./grid.css": "./dist/grid.css",
+    "./date-picker": {
+      "types": "./dist/date-picker.d.ts",
+      "import": "./dist/date-picker.js"
+    },
+    "./date-picker.css": "./dist/date-picker.css",
+    "./time-picker": {
+      "types": "./dist/time-picker.d.ts",
+      "import": "./dist/time-picker.js"
+    },
+    "./time-picker.css": "./dist/time-picker.css",
+    "./date-time-picker": {
+      "types": "./dist/date-time-picker.d.ts",
+      "import": "./dist/date-time-picker.js"
+    },
+    "./date-time-picker.css": "./dist/date-time-picker.css",
+    "./date-range-picker": {
+      "types": "./dist/date-range-picker.d.ts",
+      "import": "./dist/date-range-picker.js"
+    },
+    "./date-range-picker.css": "./dist/date-range-picker.css",
+    "./font-provider": {
+      "types": "./dist/font-provider.d.ts",
+      "import": "./dist/font-provider.js"
+    },
+    "./font-provider.css": "./dist/font-provider.css",
+    "./shape-mask": {
+      "types": "./dist/shape-mask.d.ts",
+      "import": "./dist/shape-mask.js"
+    },
+    "./shape-mask.css": "./dist/shape-mask.css",
+    "./fonts/*": "./dist/fonts/*",
+    "./button": {
+      "types": "./dist/button.d.ts",
+      "import": "./dist/button.js"
+    },
+    "./button.css": "./dist/button.css",
+    "./badge": {
+      "types": "./dist/badge.d.ts",
+      "import": "./dist/badge.js"
+    },
+    "./badge.css": "./dist/badge.css",
+    "./chip": {
+      "types": "./dist/chip.d.ts",
+      "import": "./dist/chip.js"
+    },
+    "./chip.css": "./dist/chip.css",
+    "./card": {
+      "types": "./dist/card.d.ts",
+      "import": "./dist/card.js"
+    },
+    "./card.css": "./dist/card.css",
+    "./skeleton": {
+      "types": "./dist/skeleton.d.ts",
+      "import": "./dist/skeleton.js"
+    },
+    "./skeleton.css": "./dist/skeleton.css",
+    "./command-palette": {
+      "types": "./dist/command-palette.d.ts",
+      "import": "./dist/command-palette.js"
+    },
+    "./command-palette.css": "./dist/command-palette.css",
+    "./splitter": {
+      "types": "./dist/splitter.d.ts",
+      "import": "./dist/splitter.js"
+    },
+    "./splitter.css": "./dist/splitter.css",
+    "./tree-view": {
+      "types": "./dist/tree-view.d.ts",
+      "import": "./dist/tree-view.js"
+    },
+    "./tree-view.css": "./dist/tree-view.css",
+    "./modal": {
+      "types": "./dist/modal.d.ts",
+      "import": "./dist/modal.js"
+    },
+    "./modal.css": "./dist/modal.css",
+    "./notification": {
+      "types": "./dist/notification.d.ts",
+      "import": "./dist/notification.js"
+    },
+    "./notification.css": "./dist/notification.css",
+    "./qr-code": {
+      "types": "./dist/qr-code.d.ts",
+      "import": "./dist/qr-code.js"
+    },
+    "./qr-code.css": "./dist/qr-code.css",
+    "./tour": {
+      "types": "./dist/tour.d.ts",
+      "import": "./dist/tour.js"
+    },
+    "./tour.css": "./dist/tour.css",
+    "./empty-state": {
+      "types": "./dist/empty-state.d.ts",
+      "import": "./dist/empty-state.js"
+    },
+    "./empty-state.css": "./dist/empty-state.css",
+    "./sparkline": {
+      "types": "./dist/sparkline.d.ts",
+      "import": "./dist/sparkline.js"
+    },
+    "./sparkline.css": "./dist/sparkline.css",
+    "./app-layout": {
+      "types": "./dist/app-layout.d.ts",
+      "import": "./dist/app-layout.js"
+    },
+    "./app-layout.css": "./dist/app-layout.css",
+    "./page-layout": {
+      "types": "./dist/page-layout.d.ts",
+      "import": "./dist/page-layout.js"
+    },
+    "./page-layout.css": "./dist/page-layout.css",
+    "./notification-center": {
+      "types": "./dist/notification-center.d.ts",
+      "import": "./dist/notification-center.js"
+    },
+    "./notification-center.css": "./dist/notification-center.css",
+    "./video-player": {
+      "types": "./dist/video-player.d.ts",
+      "import": "./dist/video-player.js"
+    },
+    "./video-player.css": "./dist/video-player.css",
+    "./video-lightbox": {
+      "types": "./dist/video-lightbox.d.ts",
+      "import": "./dist/video-lightbox.js"
+    },
+    "./video-lightbox.css": "./dist/video-lightbox.css",
+    "./media-image": {
+      "types": "./dist/media-image.d.ts",
+      "import": "./dist/media-image.js"
+    },
+    "./media-image.css": "./dist/media-image.css",
+    "./media-card": {
+      "types": "./dist/media-card.d.ts",
+      "import": "./dist/media-card.js"
+    },
+    "./media-card.css": "./dist/media-card.css",
+    "./image-compare": {
+      "types": "./dist/image-compare.d.ts",
+      "import": "./dist/image-compare.js"
+    },
+    "./image-compare.css": "./dist/image-compare.css",
+    "./text-highlight": {
+      "types": "./dist/text-highlight.d.ts",
+      "import": "./dist/text-highlight.js"
+    },
+    "./text-highlight.css": "./dist/text-highlight.css",
+    "./content-carousel": {
+      "types": "./dist/content-carousel.d.ts",
+      "import": "./dist/content-carousel.js"
+    },
+    "./content-carousel.css": "./dist/content-carousel.css",
+    "./profile-card": {
+      "types": "./dist/profile-card.d.ts",
+      "import": "./dist/profile-card.js"
+    },
+    "./profile-card.css": "./dist/profile-card.css",
+    "./quote-card": {
+      "types": "./dist/quote-card.d.ts",
+      "import": "./dist/quote-card.js"
+    },
+    "./quote-card.css": "./dist/quote-card.css",
+    "./collection-layout": {
+      "types": "./dist/collection-layout.d.ts",
+      "import": "./dist/collection-layout.js"
+    },
+    "./collection-layout.css": "./dist/collection-layout.css",
+    "./hero-section": {
+      "types": "./dist/hero-section.d.ts",
+      "import": "./dist/hero-section.js"
+    },
+    "./hero-section.css": "./dist/hero-section.css",
+    "./split-section": {
+      "types": "./dist/split-section.d.ts",
+      "import": "./dist/split-section.js"
+    },
+    "./split-section.css": "./dist/split-section.css",
+    "./logo-cloud": {
+      "types": "./dist/logo-cloud.d.ts",
+      "import": "./dist/logo-cloud.js"
+    },
+    "./logo-cloud.css": "./dist/logo-cloud.css",
+    "./chip-group": {
+      "types": "./dist/chip-group.d.ts",
+      "import": "./dist/chip-group.js"
+    },
+    "./chip-group.css": "./dist/chip-group.css",
+    "./content": {
+      "types": "./dist/content.d.ts",
+      "import": "./dist/content.js"
+    },
+    "./content.css": "./dist/content.css",
+    "./marketing-template-layout.css": "./dist/marketing-template-layout.css"
+  },
+  "files": [
+    "dist",
+    "src",
+    "styles",
+    "scripts/build.mjs",
+    "scripts/verify-package.mjs",
+    "tsconfig.json",
+    "edition.json",
+    "README.md",
+    "LICENSE.txt",
+    "THIRD_PARTY_NOTICES.txt",
+    "test",
+    "npm-shrinkwrap.json",
+    "docs/PUBLISHING.md",
+    "assets"
+  ],
+  "sideEffects": [
+    "**/*.css",
+    "./src/theme-runtime.ts",
+    "./dist/theme.js"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "node --test test/*.test.mjs",
+    "check": "tsc --noEmit",
+    "prepack": "npm run check && npm run build && npm test",
+    "verify:package": "node scripts/verify-package.mjs"
+  },
+  "dependencies": {
+    "ag-grid-community": "36.2.0"
+  },
+  "devDependencies": {
+    "esbuild": "0.28.2",
+    "typescript": "~6.0.3",
+    "acorn": "8.19.0"
+  }
+}

package/scripts/build.mjs

@@ -0,0 +1,34 @@
+import {build} from 'esbuild';
+import {readFile,writeFile,mkdir,rm,cp} from 'node:fs/promises';
+import {execFileSync} from 'node:child_process';
+import {gzipSync} from 'node:zlib';
+const edition=JSON.parse(await readFile('edition.json','utf8'));
+const slug=n=>edition.componentEntries?.[n]||n.replace(/([a-z])([A-Z])/g,'$1-$2').toLowerCase();
+const essentials=['button','badge','chip','chip-group','card','skeleton','empty-state'];
+const additions=edition.components.map(slug).filter(n=>!essentials.includes(n)&&n!=='grid-basic');
+const groups=Object.fromEntries(Object.entries(edition.nativeModules).map(([k,v])=>[k.split('_').at(-1).toLowerCase(),v.map(slug)]));
+const entries=[...new Set(['index','grid-basic','essentials','theme',...essentials,...additions,...Object.keys(groups)])];
+await rm('dist',{recursive:true,force:true});await mkdir('dist');
+const web=await build({entryPoints:entries.map(n=>'src/'+n+'.ts'),bundle:true,splitting:true,format:'esm',target:'es2020',minify:true,outdir:'dist',metafile:true});
+const nativeEntries={'bluui-community':'src/native.ts','bluui-community-grid':'src/native-grid.ts'};
+for(const name of additions){
+ const source=await readFile('src/component-factories/'+name+'.ts','utf8');
+ const installs=[...source.matchAll(/import \{(install\w+)\} from ['"]\.\.\/runtime\/([^'"]+)\.js['"]/g)];
+ if(installs.length){const code=installs.map(m=>`import {${m[1]}} from '../runtime/${m[2]}.js';\n${m[1]}();`).join('\n');await mkdir('src/native-components',{recursive:true});await writeFile('src/native-components/'+name+'.ts',code+'\n');nativeEntries['native/'+name]='src/native-components/'+name+'.ts';}
+}
+const native=await build({entryPoints:nativeEntries,bundle:true,format:'iife',target:'es2018',minify:true,outdir:'dist',metafile:true});
+execFileSync('node',['node_modules/typescript/bin/tsc'],{stdio:'inherit'});
+const sheets={};for(const name of edition.components.map(slug)){sheets[name]=await readFile(`styles/${name}.css`,'utf8');await cp(`styles/${name}.css`,`dist/${name}.css`);}
+await cp('styles/theme.css','dist/theme.css');
+await cp('styles/marketing-template-layout.css','dist/marketing-template-layout.css');
+await cp('assets/fonts','dist/fonts',{recursive:true});
+await writeFile('dist/essentials.css',essentials.map(n=>sheets[n]).join('\n'));
+for(const[name,members]of Object.entries(groups))await writeFile('dist/'+name+'.css',members.map(n=>sheets[n]).join('\n'));
+await writeFile('dist/styles.css',await readFile('styles/theme.css','utf8')+'\n'+Object.values(sheets).join('\n'));
+const inputs=[...new Set([...Object.keys(web.metafile.inputs),...Object.keys(native.metafile.inputs)])];
+for(const file of inputs)if(!file.startsWith('src/')&&!file.startsWith('node_modules/ag-grid-community/')&&!file.startsWith('node_modules/ag-stack/'))throw Error('Unexpected source in Community bundle: '+file);
+await writeFile('dist/build-audit.json',JSON.stringify({inputs,outputs:Object.keys({...web.metafile.outputs,...native.metafile.outputs}),sourcePolicy:edition.sourcePolicy},null,2));
+const sizes={version:edition.version,typescript:{},native:{}};
+for(const file of ['bluui-community.js','bluui-community-grid.js','styles.css','grid-basic.css','essentials.css','theme.css',...Object.keys(nativeEntries).filter(n=>n.startsWith('native/')).map(n=>n+'.js')]){const b=await readFile('dist/'+file);const measure={bytes:b.length,gzipBytes:gzipSync(b).length};if(file.startsWith('native/'))sizes.native[file]=measure;else sizes[file]=measure;}
+for(const entry of entries){const seen=new Set();const visit=file=>{if(seen.has(file))return;seen.add(file);for(const im of web.metafile.outputs[file]?.imports||[])if(!im.external)visit(im.path);};visit('dist/'+entry+'.js');let bytes=0,gzipBytes=0;for(const f of seen){const b=await readFile(f);bytes+=b.length;gzipBytes+=gzipSync(b).length;}sizes.typescript[entry]={files:[...seen].map(f=>f.slice(5)),bytes,gzipBytes};}
+await writeFile('dist/sizes.json',JSON.stringify(sizes,null,2));console.log(`Built Community ${edition.version}: ${edition.components.length} components, ${Object.keys(groups).length} groups, ${Object.keys(sizes.native).length} selective native scripts.`);

package/scripts/verify-package.mjs

@@ -0,0 +1,136 @@
+// Verify the archive consumers will install. Never publishes to a registry.
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { cp, mkdir, mkdtemp, readFile, readdir, realpath, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { build } from 'esbuild';
+
+const root = fileURLToPath(new URL('../', import.meta.url));
+const release = path.join(root, 'release');
+const pkg = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
+const edition = JSON.parse(await readFile(path.join(root, 'edition.json'), 'utf8'));
+assert.equal(pkg.name, '@blukavantui/community');
+assert.equal(pkg.version, edition.version, 'Update edition.json to match the release version');
+assert.notEqual(pkg.private, true, 'The Community package must be publishable');
+assert.equal(pkg.publishConfig?.access, 'public');
+assert.equal(pkg.publishConfig?.registry, 'https://registry.npmjs.org/');
+for (const name of ['package-lock.json', 'npm-shrinkwrap.json']) {
+  const lock = JSON.parse(await readFile(path.join(root, name), 'utf8').catch(() => 'null'));
+  if (lock) {
+    assert.equal(lock.version, pkg.version, `${name} version is stale`);
+    assert.equal(lock.packages[''].version, pkg.version, `${name} root version is stale`);
+  }
+}
+
+function npm(args, cwd = root, capture = false) {
+  const executable = process.env.npm_execpath;
+  return execFileSync(executable ? process.execPath : 'npm', executable ? [executable, ...args] : args, {
+    cwd, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024,
+    stdio: capture ? ['ignore', 'pipe', 'inherit'] : 'inherit',
+  });
+}
+const sha256 = bytes => createHash('sha256').update(bytes).digest('hex');
+// Fail if a source edit lands while we are preparing the release. Native wrappers
+// and dist are generated by the build and are checked in the packed-file digest.
+async function sourceDigest() {
+  const hash = createHash('sha256');
+  async function visit(directory, relative = '') {
+    for (const entry of (await readdir(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+      const name = relative ? `${relative}/${entry.name}` : entry.name;
+      if (['node_modules', 'dist', 'release', '.git', 'src/native-components'].includes(name)) continue;
+      if (entry.isDirectory()) await visit(path.join(directory, entry.name), name);
+      else if (entry.isFile()) hash.update(name).update('\0').update(await readFile(path.join(directory, entry.name))).update('\0');
+      else throw new Error(`Unexpected non-file entry: ${name}`);
+    }
+  }
+  await visit(root);
+  return hash.digest('hex');
+}
+const initialSourceDigest = await sourceDigest();
+console.log('Building and checking Community before packing…');
+npm(['run', 'prepack']);
+await mkdir(release, { recursive: true });
+const staging = await mkdtemp(path.join(release, '.verify-'));
+const consumer = await realpath(await mkdtemp(path.join(tmpdir(), 'blukavantui-consumer-')));
+try {
+  // prepack was run explicitly above so stdout here is only the JSON manifest.
+  const [packed] = JSON.parse(npm(['pack', '--json', '--ignore-scripts', '--pack-destination', staging], root, true));
+  const archive = path.join(staging, packed.filename);
+  const files = new Set(packed.files.map(file => file.path));
+  const required = ['package.json', 'README.md', 'LICENSE.txt', 'THIRD_PARTY_NOTICES.txt', 'edition.json', 'dist/fonts/manifest.json'];
+  for (const file of required) assert.ok(files.has(file), `Missing package file: ${file}`);
+  const proSlug = /(?:^|\/)(?:form-builder|form-renderer|image-annotator|data-import-wizard|matrix-editor|filter-builder|project-timeline|kanban|video-annotator)(?:[./]|$)/;
+  for (const file of files) {
+    assert.ok(!/(?:^|\/)(?:node_modules|release|\.git)(?:\/|$)/.test(file), `Unexpected packed path: ${file}`);
+    assert.ok(!/(?:^|\/)(?:\.env(?:\..*)?|\.npmrc|id_rsa|id_ed25519)$|\.(?:pem|key)$/.test(file), `Unexpected credential filename: ${file}`);
+    assert.ok(!/ \d+(?:\.|\/)/.test(file), `Duplicate copy in package: ${file}`);
+    assert.ok(file !== 'src/grid-runtime.js', `Full Pro Grid runtime in Community: ${file}`);
+    assert.ok(!proSlug.test(file), `Pro implementation path in Community: ${file}`);
+  }
+  const entrypoints = Object.entries(pkg.exports).filter(([name]) => !name.includes('*'));
+  for (const [name, target] of entrypoints) {
+    for (const file of typeof target === 'string' ? [target] : Object.values(target)) {
+      assert.ok(files.has(file.replace(/^\.\//, '')), `Missing export ${name}: ${file}`);
+    }
+  }
+  // Remember exact bytes so an in-flight edit cannot silently invalidate the test.
+  const hashes = Object.fromEntries(await Promise.all([...files].map(async name => [name, sha256(await readFile(path.join(root, name)))])));
+  await writeFile(path.join(consumer, 'package.json'), JSON.stringify({ name: 'community-package-verification', version: '1.0.0', private: true, type: 'module' }));
+  console.log('Installing the archive into an isolated consumer…');
+  npm(['install', archive, '--ignore-scripts', '--no-audit', '--no-fund'], consumer);
+  const installed = path.join(consumer, 'node_modules', '@blukavantui', 'community');
+  assert.equal(await realpath(installed), installed, 'Consumer must use extracted files, not a link to the source tree');
+  for (const [name, hash] of Object.entries(hashes)) {
+    assert.equal(sha256(await readFile(path.join(installed, name))), hash, `Archive differs from checked files: ${name}`);
+  }
+
+  const modules = entrypoints.filter(([, target]) => typeof target === 'object' && target.import);
+  const css = entrypoints.filter(([name]) => name.endsWith('.css'));
+  const imports = modules.map(([name], i) => `import * as entry${i} from '${pkg.name}${name === '.' ? '' : name.slice(1)}';\nconsole.log(entry${i});`);
+  imports.push(...css.map(([name]) => `import '${pkg.name}${name.slice(1)}';`));
+  // Compile the actual quick-start snippets in README, including their public types.
+  const readme = await readFile(path.join(installed, 'README.md'), 'utf8');
+  const snippets = [...readme.matchAll(/```ts\n([\s\S]*?)```/g)];
+  for (const [i, snippet] of snippets.entries()) {
+    await writeFile(path.join(consumer, `readme-${i}.ts`), snippet[1]);
+    imports.push(`import './readme-${i}.js';`);
+  }
+  const fonts = JSON.parse(await readFile(path.join(installed, 'dist/fonts/manifest.json'), 'utf8'));
+  let fontCount = 0;
+  for (const family of fonts) {
+    const slug = family.package.split('/').at(-1);
+    assert.ok(files.has(`dist/fonts/${slug}-LICENSE.txt`), `Missing font license: ${slug}`);
+    for (const font of family.files) {
+      assert.equal(sha256(await readFile(path.join(installed, 'dist/fonts', font.File))), font.sha256, `Font checksum mismatch: ${font.File}`);
+      fontCount++;
+    }
+  }
+  imports.push(`import fontUrl from '${pkg.name}/fonts/${fonts[0].files[0].File}';\nconsole.log(fontUrl);`);
+  await writeFile(path.join(consumer, 'consumer.ts'), imports.join('\n'));
+  await writeFile(path.join(consumer, 'assets.d.ts'), "declare module '*.css';\ndeclare module '*.woff2' { const url: string; export default url; }\n");
+  const config = { compilerOptions: { target: 'ES2022', module: 'NodeNext', moduleResolution: 'NodeNext', strict: true, skipLibCheck: false, noEmit: true, noUncheckedSideEffectImports: true, lib: ['ES2022', 'DOM'] }, include: ['*.ts'] };
+  await writeFile(path.join(consumer, 'tsconfig.json'), JSON.stringify(config));
+  const tsc = path.join(root, 'node_modules/typescript/bin/tsc');
+  execFileSync(process.execPath, [tsc, '-p', consumer], { stdio: 'inherit' });
+  execFileSync(process.execPath, [tsc, '-p', consumer, '--module', 'ESNext', '--moduleResolution', 'Bundler'], { stdio: 'inherit' });
+  const bundled = await build({ absWorkingDir: consumer, entryPoints: ['consumer.ts'], outdir: 'build', bundle: true, format: 'esm', platform: 'browser', target: 'es2022', loader: { '.woff2': 'file' }, metafile: true });
+  assert.ok(Object.keys(bundled.metafile.inputs).some(name => name.startsWith('node_modules/@blukavantui/community/')), 'Bundle did not consume the installed package');
+  assert.ok(Object.keys(bundled.metafile.outputs).some(name => name.endsWith('.css')), 'No consumer CSS emitted');
+  assert.ok(Object.keys(bundled.metafile.outputs).some(name => name.endsWith('.woff2')), 'Font subpath did not resolve');
+  assert.equal(await sourceDigest(), initialSourceDigest, 'Source changed during verification; rerun after edits settle');
+  for (const [name, hash] of Object.entries(hashes)) {
+    assert.equal(sha256(await readFile(path.join(root, name))), hash, `File changed during verification: ${name}`);
+  }
+  const archiveSha256 = sha256(await readFile(archive));
+  const report = { verifiedAt: new Date().toISOString(), package: pkg.name, version: pkg.version, filename: packed.filename, archiveSha256, npmIntegrity: packed.integrity, bytes: packed.size, unpackedBytes: packed.unpackedSize, files: packed.entryCount, sourceSha256: initialSourceDigest, checks: { prepack: 'typecheck, clean build, contract and isolation tests passed', archive: 'isolated npm install matches checked files', exports: entrypoints.length, moduleEntries: modules.length, stylesheets: css.length, readmeExamples: snippets.length, fontFiles: fontCount, typescript: ['NodeNext', 'Bundler'], browserBundle: 'all public JS/CSS entries and a font subpath bundled' }, limitations: ['This verifies the recorded source snapshot; rerun after component edits.', 'Browser interaction and native OutSystems release validation are separate checks.'] };
+  await cp(archive, path.join(release, packed.filename));
+  await writeFile(path.join(release, 'verification.json'), JSON.stringify(report, null, 2) + '\n');
+  console.log(JSON.stringify(report, null, 2));
+  console.log(`Verified archive: ${path.join(release, packed.filename)}\nNothing has been published.`);
+} finally {
+  await rm(staging, { recursive: true, force: true });
+  await rm(consumer, { recursive: true, force: true });
+}

package/src/advanced-types.ts

@@ -0,0 +1,89 @@
+import type {Callback,CommonOptions,Slot} from './types.js';
+
+/** Calendar date strings are YYYY-MM-DD; local date-times are YYYY-MM-DDTHH:mm. */
+export interface BluDisabledDate {Date:string}
+export interface BluDateRangePreset {Label:string;StartDate:string;EndDate:string}
+export interface PickerOptions extends CommonOptions {
+ Label?:string;
+ IsDisabled?:boolean;
+ IsReadOnly?:boolean;
+ IsRequired?:boolean;
+ Placeholder?:string;
+ ShowClear?:boolean;
+ /** Inclusive bounds, in the same stored format as Value. */
+ Min?:string;
+ Max?:string;
+}
+export interface CalendarOptions {
+ Locale?:string;
+ DateFormat?:'YYYY-MM-DD'|'MM/DD/YYYY'|'DD/MM/YYYY';
+ /** Sunday=0, Monday=1. Default 1. */
+ FirstDayOfWeek?:number;
+ ShowToday?:boolean;
+ DisabledDates?:BluDisabledDate[];
+}
+export interface ClockOptions {
+ HourCycle?:12|24;
+ /** 1–60. Controls offered minute choices; typed off-interval values are preserved. */
+ MinuteStep?:number;
+}
+export interface PickerEvents {
+ Change?:Callback<[value:string]>;
+ ValidationChanged?:Callback<[isValid:boolean,message:string]>;
+ OpenChanged?:Callback<[isOpen:boolean]>;
+ Error?:Callback<[message:string]>;
+}
+export interface DatePickerOptions extends PickerOptions,CalendarOptions {Value?:string}
+export interface TimePickerOptions extends PickerOptions,ClockOptions {Value?:string}
+export interface DateTimePickerOptions extends PickerOptions,CalendarOptions,ClockOptions {Value?:string}
+export interface DateRangePickerOptions extends PickerOptions,CalendarOptions {
+ StartDate?:string;
+ EndDate?:string;
+ Presets?:BluDateRangePreset[];
+ /** Inclusive number of calendar days. Zero means no additional limit. */
+ MinRangeDays?:number;
+ MaxRangeDays?:number;
+}
+export interface DateRangePickerEvents extends Omit<PickerEvents,'Change'> {Change?:Callback<[startDate:string,endDate:string]>}
+export type FontPreset='System sans'|'System serif'|'System monospace'|'Inter'|'Roboto'|'Source Sans 3'|'DM Sans'|'Manrope'|'Montserrat'|'Lora'|'Merriweather'|'Playfair Display'|'IBM Plex Mono'|'JetBrains Mono'|'Custom';
+/** Additional custom font weights, italics or Unicode subsets. Role must use Custom. */
+export interface BluFontFace {Role:'Body'|'Heading';Url:string;Weight?:string;Style?:'normal'|'italic'|'oblique';UnicodeRange?:string}
+export interface FontProviderOptions extends CommonOptions {
+ BodyFont?:FontPreset;
+ HeadingFont?:FontPreset|'Inherit';
+ BodyFontFamily?:string;
+ HeadingFontFamily?:string;
+ BodyFontUrl?:string;
+ HeadingFontUrl?:string;
+ /** CSS weight descriptor: e.g. 400 for static or 100 900 for a variable file. */
+ BodyFontWeight?:string;
+ HeadingFontWeight?:string;
+ BodyFallback?:string;
+ HeadingFallback?:string;
+ FontFaces?:BluFontFace[];
+ Scope?:'Page'|'Container';
+ /** Container scope uses this element ID, or its Content slot when empty. */
+ TargetId?:string;
+ Content?:Slot;
+ /** Defaults to the package's bundled fonts directory. Copy that directory when bundling. */
+ PresetBaseUrl?:string;
+}
+export interface FontProviderEvents {Loaded?:Callback<[bodyFamily:string,headingFamily:string]>;Error?:Callback<[message:string]>}
+export interface ShapeMaskOptions extends CommonOptions {
+ Content:Slot;
+ Shape?:'None'|'Circle'|'Oval'|'Diamond'|'Hexagon'|'Arch'|'Organic'|'Custom';
+ /** SVG or image alpha mask. Relative or HTTP(S), including OutSystems Resource URLs. */
+ MaskUrl?:string;
+ AspectRatio?:string;
+ MaskSize?:number;
+ PositionX?:number;
+ PositionY?:number;
+ Rotation?:number;
+ FlipHorizontal?:boolean;
+ FlipVertical?:boolean;
+ Animation?:'None'|'Reveal'|'Zoom';
+ AnimationDuration?:number;
+ /** Change to replay the finite effect. Reduced motion always overrides it. */
+ AnimationKey?:string;
+}
+export interface ShapeMaskEvents {Loaded?:Callback<[url:string]>;Error?:Callback<[message:string]>}