Feat: Reorganize spec folder to be easier to discover

Author: jlukic

packages/specs/package.json

@@ -7,14 +7,14 @@
   "version": "0.18.0",
   "sideEffects": false,
   "type": "module",
-  "main": "src/index.js",
-  "module": "src/index.js",
+  "main": "src/browser.js",
+  "module": "src/browser.js",
   "exports": {
     ".": {
-      "node": "./src/node/spec-reader-node.js",
-      "import": "./src/index.js",
-      "browser": "./dist/bundle/index.min.js",
-      "importmap": "./dist/cdn/index.min.js"
+      "node": "./src/server.js",
+      "browser": "./src/browser.js",
+      "import": "./src/browser.js",
+      "default": "./src/browser.js"
     }
   },
   "scripts": {

packages/specs/src/browser.js

@@ -0,0 +1,5 @@
+export * from './helpers.js';
+export { SpecReader } from './spec-reader.js';
+export * from './states/index.js';
+export * from './types/index.js';
+export * from './variations/index.js';

packages/specs/src/helpers.js

@@ -0,0 +1,93 @@
+import {
+  ACTIVE_STATE,
+  DISABLED_STATE,
+  FOCUS_STATE,
+  HOVER_STATE,
+  LOADING_STATE,
+  PRESSED_STATE,
+} from './states/index.js';
+
+import {
+  ATTACHED_VARIATION,
+  CIRCULAR_VARIATION,
+  COLORED_VARIATION,
+  COMPACT_VARIATION,
+  FLOATED_VARIATION,
+  FLUID_VARIATION,
+  HORIZONTAL_ALIGNED_VARIATION,
+  PADDED_VARIATION,
+  SIZE_VARIATION,
+  VERTICAL_ALIGNED_VARIATION,
+} from './variations/index.js';
+
+/*******************************
+          Helpers
+*******************************/
+
+/* Add Custom Examples to Shared Options */
+export const addOptionExamples = (options, customExamples = {}) => {
+  return options.map(opt => ({
+    ...opt,
+    exampleCode: customExamples[opt.value] || opt.exampleCode,
+  }));
+};
+
+/* Filter Options by Function or Array of Values */
+export const filterVariationOptions = (variation, filter) => {
+  const filterFn = Array.isArray(filter)
+    ? (opt) => filter.includes(opt.value)
+    : filter;
+
+  return {
+    ...variation,
+    options: variation.options.filter(filterFn),
+  };
+};
+
+/* Get State Constants by Names */
+export const getStates = (stateNames) => {
+  const stateMap = {
+    hover: HOVER_STATE,
+    focus: FOCUS_STATE,
+    active: ACTIVE_STATE,
+    loading: LOADING_STATE,
+    pressed: PRESSED_STATE,
+    disabled: DISABLED_STATE,
+  };
+
+  return stateNames.map(name => stateMap[name]).filter(Boolean);
+};
+
+/* Get Variation Constants by Names */
+export const getVariations = (variationNames) => {
+  const variationMap = {
+    size: SIZE_VARIATION,
+    fluid: FLUID_VARIATION,
+    compact: COMPACT_VARIATION,
+    padded: PADDED_VARIATION,
+    colored: COLORED_VARIATION,
+    floated: FLOATED_VARIATION,
+    attached: ATTACHED_VARIATION,
+    'horizontal-aligned': HORIZONTAL_ALIGNED_VARIATION,
+    'vertical-aligned': VERTICAL_ALIGNED_VARIATION,
+    circular: CIRCULAR_VARIATION,
+  };
+
+  return variationNames.map(name => variationMap[name]).filter(Boolean);
+};
+
+/* Set Usage Level for Variation or Type */
+export const withUsageLevel = (item, usageLevel) => {
+  return {
+    ...item,
+    usageLevel,
+  };
+};
+
+/* Modify Arbitrary Properties of Variation, Type, or State */
+export const modifyVariation = (item, overrides) => {
+  return {
+    ...item,
+    ...overrides,
+  };
+};

packages/specs/src/index.js

@@ -0,0 +1,41 @@
+import { mkdirSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+import { SpecReader as BaseSpecReader } from './spec-reader.js';
+
+// Re-export all shared terms and helpers
+export * from './helpers.js';
+export * from './states/index.js';
+export * from './types/index.js';
+export * from './variations/index.js';
+
+// Server-specific version of SpecReader with file system operations
+export class SpecReader extends BaseSpecReader {
+  writeComponentSpec(path, options = {}) {
+    const { plural = this.plural, banner = '' } = options;
+
+    mkdirSync(dirname(path), { recursive: true });
+
+    const componentSpec = this.getWebComponentSpec(this.spec, { plural });
+
+    let content = '';
+    if (banner) {
+      content += `${banner}\n`;
+    }
+    content += `// Auto-generated from spec\n`;
+    content += `export default ${JSON.stringify(componentSpec, null, 2)};\n`;
+
+    writeFileSync(path, content);
+  }
+
+  writeTestFromSpec(path, options = {}) {
+    const spec = this.spec;
+    const componentSpec = this.getTestFromSpec(spec);
+
+    mkdirSync(dirname(path), { recursive: true });
+
+    let content = `// Auto-generated test spec\n`;
+    content += `export default ${JSON.stringify(componentSpec, null, 2)};\n`;
+
+    writeFileSync(path, content);
+  }
+}