astro-better-declarative-screenshots 0.1.0

package/tests/naming.test.mjs

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { deriveName } from '../src/naming.mjs';
+
+describe('deriveName', () => {
+  it('converts URL path segments to a slug', () => {
+    expect(deriveName('/admin/group/add')).toBe('admin-group-add');
+  });
+
+  it('strips leading slash', () => {
+    expect(deriveName('/admin')).toBe('admin');
+  });
+
+  it('handles root path', () => {
+    expect(deriveName('/')).toBe('screenshot');
+  });
+
+  it('handles full URLs', () => {
+    expect(deriveName('http://localhost:9011/admin/group')).toBe('admin-group');
+  });
+
+  it('ignores query string and hash', () => {
+    expect(deriveName('/admin/group?tab=members#section')).toBe('admin-group');
+  });
+
+  it('appends selector slug for single highlight', () => {
+    const result = deriveName('/admin/group', [{ selector: '#group-name' }]);
+    expect(result).toBe('admin-group-group-name');
+  });
+
+  it('appends multiple selector slugs', () => {
+    const result = deriveName('/admin/group', [
+      { selector: '.group-name' },
+      { selector: '#submit-btn' },
+    ]);
+    expect(result).toBe('admin-group-group-name-submit-btn');
+  });
+
+  it('handles complex selectors', () => {
+    const result = deriveName('/admin', [{ selector: 'input[type="text"]' }]);
+    expect(result).toBe('admin-input-type-text');
+  });
+
+  it('resolves simple collisions with numeric suffix', () => {
+    const used = new Set();
+    const a = deriveName('/admin/group', [], used);
+    const b = deriveName('/admin/group', [], used);
+    const c = deriveName('/admin/group', [], used);
+    expect(a).toBe('admin-group');
+    expect(b).toBe('admin-group-1');
+    expect(c).toBe('admin-group-2');
+  });
+
+  it('mutates the used set', () => {
+    const used = new Set();
+    deriveName('/admin', [], used);
+    expect(used.has('admin')).toBe(true);
+  });
+
+  it('handles path segments with special chars', () => {
+    expect(deriveName('/foo/bar_baz.html')).toBe('foo-bar-baz-html');
+  });
+
+  it('handles multi-part class selector', () => {
+    const result = deriveName('/page', [{ selector: '.foo .bar' }]);
+    expect(result).toBe('page-foo-bar');
+  });
+
+  it('empty highlights have no effect on the name', () => {
+    expect(deriveName('/admin/group', [])).toBe('admin-group');
+    expect(deriveName('/admin/group', [{ selector: undefined }])).toBe('admin-group');
+  });
+});

package/tests/placeholder.test.mjs

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { generatePlaceholder } from '../src/placeholder.mjs';
+import sharp from 'sharp';
+
+describe('generatePlaceholder', () => {
+  it('returns a Buffer', async () => {
+    const buf = await generatePlaceholder({ name: 'test-screenshot' });
+    expect(Buffer.isBuffer(buf)).toBe(true);
+  });
+
+  it('generates a valid PNG', async () => {
+    const buf = await generatePlaceholder({ name: 'test' });
+    const meta = await sharp(buf).metadata();
+    expect(meta.format).toBe('png');
+  });
+
+  it('uses the specified dimensions', async () => {
+    const buf = await generatePlaceholder({ name: 'test', width: 800, height: 600 });
+    const meta = await sharp(buf).metadata();
+    expect(meta.width).toBe(800);
+    expect(meta.height).toBe(600);
+  });
+
+  it('defaults to 1280x800', async () => {
+    const buf = await generatePlaceholder({ name: 'test' });
+    const meta = await sharp(buf).metadata();
+    expect(meta.width).toBe(1280);
+    expect(meta.height).toBe(800);
+  });
+
+  it('handles names with special XML characters', async () => {
+    // should not throw
+    await expect(generatePlaceholder({ name: 'foo<bar>&baz' })).resolves.toBeTruthy();
+  });
+});

package/vitest.config.mjs

@@ -0,0 +1,12 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['tests/**/*.test.mjs'],
+    environment: 'node',
+    // chrome/placeholder tests use sharp which is native -- run them serially
+    // to avoid port/resource contention
+    pool: 'forks',
+    timeout: 30000,
+  },
+});