@geastack/cli 0.1.0

package/src/args.mjs

@@ -0,0 +1,78 @@
+export function parseArgs(argv) {
+  const options = {}
+  const positionals = []
+  const passthrough = []
+  let pass = false
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    if (pass) {
+      passthrough.push(arg)
+      continue
+    }
+    if (arg === '--') {
+      pass = true
+      continue
+    }
+    if (arg === '-h') {
+      setOption(options, 'help', true)
+      continue
+    }
+    if (arg === '-v') {
+      setOption(options, 'version', true)
+      continue
+    }
+    if (arg.startsWith('--')) {
+      const raw = arg.slice(2)
+      if (raw.startsWith('no-') && !raw.includes('=')) {
+        setOption(options, raw.slice(3), false)
+        continue
+      }
+      const eq = raw.indexOf('=')
+      if (eq !== -1) {
+        setOption(options, raw.slice(0, eq), raw.slice(eq + 1))
+        continue
+      }
+      const next = argv[i + 1]
+      if (next && !next.startsWith('-')) {
+        setOption(options, raw, next)
+        i += 1
+      } else {
+        setOption(options, raw, true)
+      }
+      continue
+    }
+    positionals.push(arg)
+  }
+
+  return { options, positionals, passthrough }
+}
+
+export function option(parsed, name, fallback = undefined) {
+  const value = parsed.options[name]
+  if (value === undefined) return fallback
+  return Array.isArray(value) ? value[value.length - 1] : value
+}
+
+export function optionList(parsed, name) {
+  const value = parsed.options[name]
+  if (value === undefined) return []
+  return (Array.isArray(value) ? value : [value])
+    .flatMap((entry) => String(entry).split(','))
+    .map((entry) => entry.trim())
+    .filter(Boolean)
+}
+
+export function flag(parsed, name) {
+  return option(parsed, name, false) !== false && option(parsed, name, false) !== undefined
+}
+
+function setOption(options, name, value) {
+  if (options[name] === undefined) {
+    options[name] = value
+  } else if (Array.isArray(options[name])) {
+    options[name].push(value)
+  } else {
+    options[name] = [options[name], value]
+  }
+}

package/src/board-catalog.mjs

@@ -0,0 +1,224 @@
+export const knownBoards = Object.freeze([
+  {
+    id: 'waveshare-amoled-206',
+    label: 'Waveshare ESP32-S3 Touch AMOLED 2.06',
+    alias: 'amoled',
+    target: 'esp32-s3-touch-amoled-2.06',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3',
+    capabilities: {
+      display: '2.06 inch AMOLED touch panel',
+      touch: 'board integrated touch',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'waveshare-amoled-18',
+    label: 'Waveshare ESP32-S3 Touch AMOLED 1.8',
+    alias: 'amoled-18',
+    target: 'esp32-s3-touch-amoled-1.8',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3',
+    capabilities: {
+      display: '1.8 inch AMOLED touch panel',
+      touch: 'board integrated touch',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'lilygo-t-display-s3-long',
+    label: 'LILYGO T-Display-S3 Long',
+    alias: 't-display-long',
+    target: 'esp32-s3-lilygo-t-display-s3-long',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3R8',
+    capabilities: {
+      display: '3.4 inch 180x640 AMOLED (AXS15231B)',
+      touch: 'capacitive touch hardware (target driver pending)',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['16 MB flash', '8 MB PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'waveshare-amoled-175',
+    label: 'Waveshare ESP32-S3 Touch AMOLED 1.75',
+    alias: 'amoled-175',
+    target: 'esp32-s3-touch-amoled-1.75',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3',
+    capabilities: {
+      display: '1.75 inch AMOLED touch panel',
+      touch: 'board integrated touch',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'esp32-s3-epaper-154',
+    label: 'ESP32-S3 e-paper 1.54',
+    alias: 'epaper',
+    target: 'esp32-s3-epaper-1.54',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3',
+    capabilities: {
+      display: '1.54 inch e-paper',
+      touch: 'none',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['flash'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'elecrow-rotary-21',
+    label: 'Elecrow ESP32-S3 Rotary 2.1',
+    alias: 'rotary',
+    target: 'esp32-s3-elecrow-rotary-2.1',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-S3',
+    capabilities: {
+      display: '2.1 inch round display',
+      touch: 'rotary/input board controls',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'waveshare-p4-lcd-7',
+    label: 'Waveshare ESP32-P4 Touch LCD 7',
+    alias: 'waveshare-p4-7',
+    target: 'esp32-p4-waveshare-touch-lcd-7',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-P4',
+    capabilities: {
+      display: '7 inch RGB touch LCD',
+      touch: 'board integrated touch',
+      wireless: [],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'm5stack-tab5',
+    label: 'M5Stack Tab5',
+    alias: 'm5tab',
+    target: 'esp32-p4-m5stack-tab5',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-P4 + ESP32-C6',
+    capabilities: {
+      display: '5 inch 1280x720 IPS touch panel (ST7123/ST7121 current, ILI9881C legacy)',
+      touch: 'GT911 or ST7123/ST7121 integrated touch',
+      wireless: ['ESP32-C6 WiFi 6', 'BLE/Thread/Zigbee capable'],
+      storage: ['16 MB flash', '32 MB PSRAM', 'microSD'],
+      audio: ['ES8388 codec', 'ES7210 dual-mic AEC', 'NS4150B 1W speaker', '3.5mm headphone'],
+      gps: false,
+      sensors: ['BMI270 IMU', 'RX8130CE RTC', 'INA226 power monitor', 'IP2326 charger', 'PI4IOE5V6408 IO expanders', 'SC2356 camera', 'SIT3088 RS485']
+    }
+  },
+  {
+    id: 'waveshare-p4-lcd-35',
+    label: 'Waveshare ESP32-P4 Touch LCD 3.5',
+    alias: 'waveshare-p4-3.5',
+    target: 'esp32-p4-waveshare-touch-lcd-3.5',
+    adapter: 'esp32-idf',
+    mcu: 'ESP32-P4',
+    capabilities: {
+      display: '3.5 inch RGB touch LCD',
+      touch: 'board integrated touch',
+      wireless: [],
+      storage: ['flash', 'PSRAM'],
+      audio: [],
+      gps: false
+    }
+  },
+  {
+    id: 'waveshare-rp2350-amoled-241',
+    label: 'Waveshare RP2350 Touch AMOLED 2.41',
+    alias: 'waveshare-rp2350-amoled-2.41',
+    target: 'rp2350-waveshare-touch-amoled-2.41',
+    adapter: 'rp2350-pico',
+    mcu: 'RP2350',
+    capabilities: {
+      display: '2.41 inch 450x600 AMOLED touch panel (RM690B0)',
+      touch: 'FT6336 capacitive touch',
+      wireless: [],
+      storage: ['16 MB flash', '2 MB PSRAM'],
+      audio: [],
+      gps: false,
+      sensors: ['QMI8658 IMU', 'PCF85063 RTC', 'ETA6098 power']
+    }
+  },
+  {
+    id: 'pimoroni-tufty-2350',
+    label: 'Pimoroni Tufty 2350',
+    alias: 'tufty-2350',
+    target: 'rp2350-tufty-2350',
+    adapter: 'rp2350-pico',
+    mcu: 'RP2350',
+    capabilities: {
+      display: '2.8 inch 320x240 IPS LCD (ST7789 parallel)',
+      touch: 'none',
+      wireless: ['WiFi', 'BLE'],
+      storage: ['16 MB flash', '8 MB PSRAM'],
+      audio: [],
+      gps: false,
+      sensors: ['PCF85063 RTC', 'buttons', 'battery sense', 'rear lighting']
+    }
+  }
+])
+
+export const customBoardDefaults = Object.freeze({
+  targetFamily: 'esp32',
+  adapter: 'esp32-idf',
+  baseTarget: '',
+  mcu: '',
+  display: {
+    kind: '',
+    controller: '',
+    interface: '',
+    resolution: ''
+  },
+  touch: {
+    controller: '',
+    interface: ''
+  },
+  wireless: {
+    wifi: '',
+    ble: ''
+  },
+  gps: {
+    module: '',
+    interface: ''
+  },
+  audio: {
+    codec: '',
+    output: '',
+    input: ''
+  },
+  storage: [],
+  sensors: [],
+  power: '',
+  transports: {},
+  notes: ''
+})
+
+export function boardById(id) {
+  return knownBoards.find((board) => board.id === id) || null
+}
+
+export function boardByTarget(target) {
+  return knownBoards.find((board) => board.target === target) || null
+}

package/src/context.mjs

@@ -0,0 +1,110 @@
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { fileURLToPath } from 'node:url'
+
+import { option } from './args.mjs'
+import { exists, findUp } from './fs-utils.mjs'
+
+const srcDir = path.dirname(fileURLToPath(import.meta.url))
+export const cliPackageRoot = path.resolve(srcDir, '..')
+const requireFromCli = createRequire(import.meta.url)
+
+export function createContext(parsed, _env = process.env, cwd = process.cwd()) {
+  const absoluteCwd = path.resolve(cwd)
+  const projectRoot = findNodeProjectRoot(absoluteCwd) || absoluteCwd
+  const initialAnchors = [projectRoot, cliPackageRoot]
+  const targetsRoot = resolveInstalledPackageDir('@geastack/targets', initialAnchors)
+  const corePackageDir = resolveInstalledPackageDir('@geastack/core', initialAnchors)
+  const packageAnchors = [projectRoot, cliPackageRoot, targetsRoot, corePackageDir].filter(Boolean)
+  const compilerPackageDir = resolveInstalledPackageDir('@geastack/compiler', packageAnchors)
+  const projectBoardsConfig = path.join(projectRoot, '.gea', 'boards.json')
+  const explicitBoardsConfig = option(parsed, 'boards-config') || ''
+  const boardsConfig = explicitBoardsConfig || (exists(projectBoardsConfig) ? projectBoardsConfig : '')
+
+  const ctx = {
+    cwd: absoluteCwd,
+    projectRoot,
+    projectBoardsConfig,
+    cliPackageRoot,
+    compilerPackageDir,
+    corePackageDir,
+    chipsPackageDir: resolveInstalledPackageDir('@geastack/chips', packageAnchors),
+    elementsPackageDir: resolveInstalledPackageDir('@geastack/elements', packageAnchors),
+    enginePackageDir: resolveInstalledPackageDir('@geastack/engine', packageAnchors),
+    geaosPackageDir: resolveInstalledPackageDir('@geastack/geaos', packageAnchors),
+    hostPackageDir: resolveInstalledPackageDir('@geastack/host', packageAnchors),
+    pluginPackageDir: resolveInstalledPackageDir('@geastack/geatsc-plugin-gea', packageAnchors),
+    boardsConfig: boardsConfig ? path.resolve(absoluteCwd, boardsConfig) : '',
+    examplesRoot: projectRoot,
+    simulatorRoot: '',
+    androidRoot: '',
+    appleRoot: '',
+    targetsRoot
+  }
+  ctx.scripts = {
+    board: packageFile(ctx.targetsRoot, 'scripts', 'board'),
+    webBuild: '',
+    webDev: '',
+    androidBuild: '',
+    macosBuild: '',
+    iosBuild: '',
+    geaEmbedded: packageFile(ctx.corePackageDir, 'bin', 'gea-embedded.mjs')
+  }
+  return ctx
+}
+
+export function createChildEnv(ctx, env = process.env) {
+  const out = {
+    ...env,
+    GEA_APPS_ROOT: ctx.projectRoot,
+    GEA_CLI_BIN: path.join(ctx.cliPackageRoot, 'bin', 'gea.mjs'),
+    GEA_CHIPS_DIR: ctx.chipsPackageDir,
+    GEA_CORE_PACKAGE: ctx.corePackageDir,
+    GEA_CORE_DIR: ctx.corePackageDir,
+    GEA_COMPILER_DIR: ctx.compilerPackageDir,
+    GEA_ELEMENTS_DIR: ctx.elementsPackageDir,
+    GEA_ENGINE_DIR: ctx.enginePackageDir,
+    GEA_EXTRA_APP_DIRS: appendPathList(env.GEA_EXTRA_APP_DIRS, ctx.projectRoot),
+    GEA_GEAOS_PACKAGE_DIR: ctx.geaosPackageDir,
+    GEA_HOST_DIR: ctx.hostPackageDir,
+    GEA_PLUGIN_DIR: ctx.pluginPackageDir,
+    GEA_TARGETS_ROOT: ctx.targetsRoot
+  }
+  if (ctx.boardsConfig) out.GEA_BOARDS_CONFIG = ctx.boardsConfig
+  for (const [name, value] of Object.entries(out)) {
+    if (name.startsWith('GEA_') && value === '') delete out[name]
+  }
+  return out
+}
+
+function resolveInstalledPackageDir(packageName, anchors) {
+  for (const anchor of anchors) {
+    let current = path.resolve(anchor)
+    while (true) {
+      const candidate = path.join(current, 'node_modules', ...packageName.split('/'))
+      if (exists(path.join(candidate, 'package.json'))) return candidate
+      const parent = path.dirname(current)
+      if (parent === current) break
+      current = parent
+    }
+  }
+  try {
+    return path.dirname(requireFromCli.resolve(`${packageName}/package.json`))
+  } catch {
+    return ''
+  }
+}
+
+function packageFile(packageRoot, ...segments) {
+  return packageRoot ? path.join(packageRoot, ...segments) : ''
+}
+
+function appendPathList(current, value) {
+  const entries = String(current || '').split(path.delimiter).filter(Boolean)
+  if (value && !entries.includes(value)) entries.push(value)
+  return entries.join(path.delimiter)
+}
+
+function findNodeProjectRoot(start) {
+  return findUp(start, (dir) => exists(path.join(dir, 'package.json')))
+}