@typecad/cuttlefish 1.0.0-alpha.3 → 1.0.0-alpha.7

package/dist/api/shared/hal-op-ir.d.ts

@@ -42,6 +42,77 @@ export interface PwmGetResolutionOp {
     port?: string;
     pin: number;
 }
+export interface RmtTxInitOp {
+    operation: "rmt.tx_init";
+    port?: string;
+    pin: number;
+    resolutionHz: number | string;
+    bit0Hi: number | string;
+    bit0Lo: number | string;
+    bit1Hi: number | string;
+    bit1Lo: number | string;
+    msbFirst?: boolean | string;
+    queueDepth?: number | string;
+}
+export interface RmtTxWriteBytesOp {
+    operation: "rmt.tx_write_bytes";
+    port?: string;
+    pin: number;
+    /** Pre-rendered C array initializer body, e.g. "1, 2, 3" (positional; bytes arg is array-literal-rendered). */
+    bytes: string;
+}
+export interface RmtTxWriteSymbolsOp {
+    operation: "rmt.tx_write_symbols";
+    port?: string;
+    pin: number;
+    /** Rendered rmt_symbol_word_t array body, one row per symbol. */
+    symbols: string;
+}
+export interface RmtTxWaitDoneOp {
+    operation: "rmt.tx_wait_done";
+    port?: string;
+    pin: number;
+    timeoutMs?: number | string;
+}
+export interface RmtTxDeinitOp {
+    operation: "rmt.tx_deinit";
+    port?: string;
+    pin: number;
+}
+export interface RmtRxInitOp {
+    operation: "rmt.rx_init";
+    port?: string;
+    pin: number;
+    resolutionHz: number | string;
+}
+export interface RmtRxOnReceivedOp {
+    operation: "rmt.rx_on_received";
+    port?: string;
+    pin: number;
+    /** User-declared C function name to call on receive. */
+    handler: string;
+}
+export interface RmtRxStartOp {
+    operation: "rmt.rx_start";
+    port?: string;
+    pin: number;
+}
+export interface RmtRxStopOp {
+    operation: "rmt.rx_stop";
+    port?: string;
+    pin: number;
+}
+export interface RmtRxReadOp {
+    operation: "rmt.rx_read";
+    port?: string;
+    pin: number;
+    maxCount: number | string;
+}
+export interface RmtRxDeinitOp {
+    operation: "rmt.rx_deinit";
+    port?: string;
+    pin: number;
+}
 export interface AdcReadOp {
     operation: "adc.read";
     port?: string;
@@ -148,6 +219,11 @@ export interface PowerSetCpuFrequencyOp {
     operation: "power.set_cpu_frequency";
     mhz: number;
 }
+export interface PowerDeepSleepPinOp {
+    operation: "power.deep_sleep_pin";
+    pin: number;
+    level: number;
+}
 export interface I2cBeginOp {
     operation: "i2c.begin";
     bus: string;
@@ -267,6 +343,15 @@ export interface SpiCsHighOp {
     port?: string;
     pin: number;
 }
+export interface SpiReadBufferOp {
+    operation: "spi.read_buffer";
+    bus: string;
+    /** Number of bytes — numeric or runtime expression string */
+    count: number | string;
+    /** Buffer variable name, "__HAL_READ_BUF__" placeholder (rewritten to the
+     *  caller's variable by the variable-init transformer), or "__DISCARD__" */
+    buffer: string;
+}
 export interface UartBeginOp {
     operation: "uart.begin";
     port: string;
@@ -375,6 +460,336 @@ export interface SnprintfEmitOp {
     /** Resolved C++ argument expressions */
     args: string[];
 }
+export interface WifiConnectOp {
+    operation: "wifi.connect";
+    ssid: string;
+    password?: string;
+    timeoutMs: number | string;
+    blocking: boolean;
+}
+export interface WifiConnectStartOp {
+    operation: "wifi.connect_start";
+    ssid: string;
+    password?: string;
+}
+export interface WifiDisconnectOp {
+    operation: "wifi.disconnect";
+}
+export interface WifiStatusOp {
+    operation: "wifi.status";
+}
+export interface WifiIsConnectedOp {
+    operation: "wifi.is_connected";
+}
+export interface WifiLocalIpOp {
+    operation: "wifi.local_ip";
+}
+export interface WifiRssiOp {
+    operation: "wifi.rssi";
+}
+export interface WifiMacOp {
+    operation: "wifi.mac";
+}
+export interface WifiSetHostnameOp {
+    operation: "wifi.set_hostname";
+    name: string;
+}
+export interface WifiSetStaticIpOp {
+    operation: "wifi.set_static_ip";
+    ip: string;
+    gateway: string;
+    subnet: string;
+    dns?: string;
+}
+export interface WifiSetAutoReconnectOp {
+    operation: "wifi.set_auto_reconnect";
+    enabled: boolean | string;
+}
+export interface WifiSetPowerSaveOp {
+    operation: "wifi.set_power_save";
+    mode: string;
+}
+export interface WifiSetTxPowerOp {
+    operation: "wifi.set_tx_power";
+    dbm: number | string;
+}
+export interface WifiOnEventOp {
+    operation: "wifi.on_event";
+    event: "connect" | "disconnect" | "got_ip" | string;
+    handler: string;
+}
+export interface WifiApStartOp {
+    operation: "wifi.ap_start";
+    ssid: string;
+    password?: string;
+    channel?: number | string;
+    hidden?: boolean | string;
+    maxClients?: number | string;
+}
+export interface WifiApStopOp {
+    operation: "wifi.ap_stop";
+}
+export interface WifiApClientCountOp {
+    operation: "wifi.ap_client_count";
+}
+export interface WifiApIpOp {
+    operation: "wifi.ap_ip";
+}
+export interface WifiApSetChannelOp {
+    operation: "wifi.ap_set_channel";
+    channel: number | string;
+}
+export interface WifiApSetHiddenOp {
+    operation: "wifi.ap_set_hidden";
+    hidden: boolean | string;
+}
+export interface WifiApSetMaxClientsOp {
+    operation: "wifi.ap_set_max_clients";
+    maxClients: number | string;
+}
+export interface WifiScanOp {
+    operation: "wifi.scan";
+}
+export interface WifiScanStartOp {
+    operation: "wifi.scan_start";
+}
+/** Poll predicate paired with wifi.scan_start — true when scan results are ready. */
+export interface WifiScanDoneOp {
+    operation: "wifi.scan_done";
+}
+export interface WifiScanCountOp {
+    operation: "wifi.scan_count";
+}
+export interface WifiScanSsidOp {
+    operation: "wifi.scan_ssid";
+    index: number | string;
+}
+export interface WifiScanRssiOp {
+    operation: "wifi.scan_rssi";
+    index: number | string;
+}
+export interface WifiScanEncryptionOp {
+    operation: "wifi.scan_encryption";
+    index: number | string;
+}
+export interface WifiScanChannelOp {
+    operation: "wifi.scan_channel";
+    index: number | string;
+}
+export interface WifiSaveCredentialsOp {
+    operation: "wifi.save_credentials";
+    ssid: string;
+    password: string;
+}
+export interface WifiConnectSavedOp {
+    operation: "wifi.connect_saved";
+    timeoutMs: number | string;
+}
+export interface WifiClearCredentialsOp {
+    operation: "wifi.clear_credentials";
+}
+export interface WifiWaitConnectedOp {
+    operation: "wifi.wait_connected";
+    timeoutMs: number | string;
+}
+export interface WifiWaitDisconnectedOp {
+    operation: "wifi.wait_disconnected";
+}
+export interface HttpBeginOp {
+    operation: "http.begin";
+    method: string;
+    url: string;
+}
+export interface HttpResetOp {
+    operation: "http.reset";
+}
+export interface HttpSetHeaderOp {
+    operation: "http.set_header";
+    name: string;
+    value: string;
+}
+export interface HttpSetTimeoutOp {
+    operation: "http.set_timeout";
+    ms: number | string;
+}
+export interface HttpSetMaxBodyOp {
+    operation: "http.set_max_body";
+    bytes: number | string;
+}
+export interface HttpSetBodyOp {
+    operation: "http.set_body";
+    data: string;
+    json?: boolean;
+}
+export interface HttpSetInsecureOp {
+    operation: "http.set_insecure";
+}
+export interface HttpSetCaCertOp {
+    operation: "http.set_ca_cert";
+    pem: string;
+}
+export interface HttpSendOp {
+    operation: "http.send";
+    blocking: boolean;
+}
+export interface HttpSendStartOp {
+    operation: "http.send_start";
+}
+/** Poll predicate paired with http.send_start — true when the response is in. */
+export interface HttpDoneOp {
+    operation: "http.done";
+}
+export interface HttpStatusOp {
+    operation: "http.status";
+}
+export interface HttpOkOp {
+    operation: "http.ok";
+}
+export interface HttpBodyOp {
+    operation: "http.body";
+}
+export interface HttpContentLengthOp {
+    operation: "http.content_length";
+}
+export interface HttpResponseHeaderOp {
+    operation: "http.response_header";
+    name: string;
+}
+export interface BleServerBeginOp {
+    operation: "ble.server_begin";
+    name: string;
+}
+export interface BleAdvertiseStartOp {
+    operation: "ble.advertise_start";
+}
+export interface BleAdvertiseStopOp {
+    operation: "ble.advertise_stop";
+}
+export interface BleAddServiceOp {
+    operation: "ble.add_service";
+    uuid: string;
+}
+export interface BleAddCharOp {
+    operation: "ble.add_char";
+    index: number | string;
+    uuid: string;
+    type: string;
+    perms: number | string;
+    svcIndex?: number | string;
+}
+export interface BleOnReadOp {
+    operation: "ble.on_read";
+    index: number | string;
+    handler: string;
+}
+export interface BleOnWriteOp {
+    operation: "ble.on_write";
+    index: number | string;
+    handler: string;
+}
+export interface BleOnConnectOp {
+    operation: "ble.on_connect";
+    handler: string;
+}
+export interface BleOnDisconnectOp {
+    operation: "ble.on_disconnect";
+    handler: string;
+}
+export interface BleNotifyOp {
+    operation: "ble.notify";
+    index: number | string;
+    value: number | string;
+}
+export interface BleIsConnectedOp {
+    operation: "ble.is_connected";
+}
+export interface BleClientCountOp {
+    operation: "ble.client_count";
+}
+export interface BleSetNameOp {
+    operation: "ble.set_name";
+    name: string;
+}
+export interface BleUntilConnectedOp {
+    operation: "ble.until_connected";
+    timeoutMs: number | string;
+    blocking: boolean;
+}
+export interface BleUntilConnectedStartOp {
+    operation: "ble.until_connected_start";
+}
+export interface BleSetTxPowerOp {
+    operation: "ble.set_tx_power";
+    dbm: number | string;
+}
+export interface BleStatusOp {
+    operation: "ble.status";
+}
+export interface PreferencesBeginOp {
+    operation: "preferences.begin";
+    namespace: string;
+    readOnly: boolean;
+}
+export interface PreferencesEndOp {
+    operation: "preferences.end";
+}
+export interface PreferencesClearOp {
+    operation: "preferences.clear";
+}
+export interface PreferencesRemoveOp {
+    operation: "preferences.remove";
+    key: string;
+}
+export interface PreferencesPutIntOp {
+    operation: "preferences.put_int";
+    key: string;
+    value: number | string;
+}
+export interface PreferencesGetIntOp {
+    operation: "preferences.get_int";
+    key: string;
+    defaultValue: number | string;
+}
+export interface PreferencesPutUIntOp {
+    operation: "preferences.put_uint";
+    key: string;
+    value: number | string;
+}
+export interface PreferencesGetUIntOp {
+    operation: "preferences.get_uint";
+    key: string;
+    defaultValue: number | string;
+}
+export interface PreferencesPutBoolOp {
+    operation: "preferences.put_bool";
+    key: string;
+    value: boolean;
+}
+export interface PreferencesGetBoolOp {
+    operation: "preferences.get_bool";
+    key: string;
+    defaultValue: boolean;
+}
+export interface PreferencesPutFloatOp {
+    operation: "preferences.put_float";
+    key: string;
+    value: number | string;
+}
+export interface PreferencesGetFloatOp {
+    operation: "preferences.get_float";
+    key: string;
+    defaultValue: number | string;
+}
+export interface PreferencesPutStringOp {
+    operation: "preferences.put_string";
+    key: string;
+    value: string;
+}
+export interface PreferencesGetStringOp {
+    operation: "preferences.get_string";
+    key: string;
+    defaultValue: string;
+}
 export interface RawCppOp {
     operation: "raw";
     /** Raw C++ code string (framework-agnostic, use sparingly) */
@@ -385,9 +800,20 @@ export interface RawCppOp {
  * operations. Each node carries a semantic `operation` tag and typed
  * arguments. Framework strategies translate these into concrete C++.
  */
-export type HALOpIR = GpioWriteOp | GpioReadOp | GpioToggleOp | GpioSetModeOp | PwmWriteOp | PwmGetFrequencyOp | PwmGetResolutionOp | AdcReadOp | AdcGetResolutionOp | AdcSetReferenceOp | AdcGetReferenceOp | AdcReadVoltageOp | DacWriteOp | InterruptAttachOp | InterruptDetachOp | TonePlayOp | ToneStopOp | TimingDelayOp | TimingDelayMicrosecondsOp | TimingMillisOp | TimingMicrosOp | TimingFreeHeapOp | TimingSetIntervalOp | TimingSetTimeoutOp | TimingClearIntervalOp | TimingClearTimeoutOp | PowerDeepSleepOp | PowerLightSleepOp | PowerSetCpuFrequencyOp | I2cBeginOp | I2cEndOp | I2cSetClockOp | I2cBeginTransmissionOp | I2cWriteOp | I2cWriteBytesOp | I2cWriteBufferOp | I2cReadBufferOp | I2cEndTransmissionOp | I2cRequestFromOp | I2cAvailableOp | I2cReadOp | I2cRecoverOp | SpiBeginOp | SpiEndOp | SpiTransferOp | SpibeginTransactionOp | SpiEndTransactionOp | SpiSetModeOp | SpiSetBitOrderOp | SpiCsLowOp | SpiCsHighOp | UartBeginOp | UartEndOp | UartPrintOp | UartPrintlnOp | UartPrintfOp | UartWriteOp | UartReadOp | UartPeekOp | UartAvailableOp | UartFlushOp | PulseInOp | PulseInLongOp | ShiftOutOp | ShiftInOp | BoardResolveOp | WdtEnableOp | WdtResetOp | WdtDisableOp | SnprintfEmitOp | RawCppOp | DisplayHALOp;
+export type HALOpIR = GpioWriteOp | GpioReadOp | GpioToggleOp | GpioSetModeOp | PwmWriteOp | PwmGetFrequencyOp | PwmGetResolutionOp | RmtTxInitOp | RmtTxWriteBytesOp | RmtTxWriteSymbolsOp | RmtTxWaitDoneOp | RmtTxDeinitOp | RmtRxInitOp | RmtRxOnReceivedOp | RmtRxStartOp | RmtRxStopOp | RmtRxReadOp | RmtRxDeinitOp | AdcReadOp | AdcGetResolutionOp | AdcSetReferenceOp | AdcGetReferenceOp | AdcReadVoltageOp | DacWriteOp | InterruptAttachOp | InterruptDetachOp | TonePlayOp | ToneStopOp | TimingDelayOp | TimingDelayMicrosecondsOp | TimingMillisOp | TimingMicrosOp | TimingFreeHeapOp | TimingSetIntervalOp | TimingSetTimeoutOp | TimingClearIntervalOp | TimingClearTimeoutOp | PowerDeepSleepOp | PowerLightSleepOp | PowerSetCpuFrequencyOp | PowerDeepSleepPinOp | I2cBeginOp | I2cEndOp | I2cSetClockOp | I2cBeginTransmissionOp | I2cWriteOp | I2cWriteBytesOp | I2cWriteBufferOp | I2cReadBufferOp | I2cEndTransmissionOp | I2cRequestFromOp | I2cAvailableOp | I2cReadOp | I2cRecoverOp | SpiBeginOp | SpiEndOp | SpiTransferOp | SpibeginTransactionOp | SpiEndTransactionOp | SpiSetModeOp | SpiSetBitOrderOp | SpiCsLowOp | SpiCsHighOp | SpiReadBufferOp | UartBeginOp | UartEndOp | UartPrintOp | UartPrintlnOp | UartPrintfOp | UartWriteOp | UartReadOp | UartPeekOp | UartAvailableOp | UartFlushOp | PulseInOp | PulseInLongOp | ShiftOutOp | ShiftInOp | BoardResolveOp | WdtEnableOp | WdtResetOp | WdtDisableOp | SnprintfEmitOp | WifiConnectOp | WifiConnectStartOp | WifiDisconnectOp | WifiStatusOp | WifiIsConnectedOp | WifiLocalIpOp | WifiRssiOp | WifiMacOp | WifiSetHostnameOp | WifiSetStaticIpOp | WifiSetAutoReconnectOp | WifiSetPowerSaveOp | WifiSetTxPowerOp | WifiOnEventOp | WifiApStartOp | WifiApStopOp | WifiApClientCountOp | WifiApIpOp | WifiApSetChannelOp | WifiApSetHiddenOp | WifiApSetMaxClientsOp | WifiScanOp | WifiScanStartOp | WifiScanDoneOp | WifiScanCountOp | WifiScanSsidOp | WifiScanRssiOp | WifiScanEncryptionOp | WifiScanChannelOp | WifiSaveCredentialsOp | WifiConnectSavedOp | WifiClearCredentialsOp | WifiWaitConnectedOp | WifiWaitDisconnectedOp | HttpBeginOp | HttpResetOp | HttpSetHeaderOp | HttpSetTimeoutOp | HttpSetMaxBodyOp | HttpSetBodyOp | HttpSetInsecureOp | HttpSetCaCertOp | HttpSendOp | HttpSendStartOp | HttpDoneOp | HttpStatusOp | HttpOkOp | HttpBodyOp | HttpContentLengthOp | HttpResponseHeaderOp | BleServerBeginOp | BleAdvertiseStartOp | BleAdvertiseStopOp | BleAddServiceOp | BleAddCharOp | BleOnReadOp | BleOnWriteOp | BleOnConnectOp | BleOnDisconnectOp | BleNotifyOp | BleIsConnectedOp | BleClientCountOp | BleSetNameOp | BleUntilConnectedOp | BleUntilConnectedStartOp | BleSetTxPowerOp | BleStatusOp | PreferencesBeginOp | PreferencesEndOp | PreferencesClearOp | PreferencesRemoveOp | PreferencesPutIntOp | PreferencesGetIntOp | PreferencesPutUIntOp | PreferencesGetUIntOp | PreferencesPutBoolOp | PreferencesGetBoolOp | PreferencesPutFloatOp | PreferencesGetFloatOp | PreferencesPutStringOp | PreferencesGetStringOp | RawCppOp | DisplayHALOp;
 /**
  * Helper type: extracts the operation string from a HALOpIR variant.
  * Useful for type-safe switch statements in framework strategies.
  */
 export type HALOperationKind = HALOpIR["operation"];
+/**
+ * Runtime registry of every HAL operation discriminator, parallel to
+ * {@link DISPLAY_OPERATION_KINDS}. Lets tests and the manifest validator
+ * enumerate HAL op kinds without parsing types (which are erased at runtime).
+ * Keep in sync with {@link HALOpIR} above.
+ *
+ * Note: `display.*` ops are NOT listed here — they live in
+ * {@link DISPLAY_OPERATION_KINDS} in `display-op-ir.ts`. The manifest
+ * validator imports both and unions them when probing display ops.
+ */
+export declare const HAL_OPERATION_KINDS: readonly ["gpio.write", "gpio.read", "gpio.toggle", "gpio.set_mode", "pwm.write", "pwm.get_frequency", "pwm.get_resolution", "rmt.tx_init", "rmt.tx_write_bytes", "rmt.tx_write_symbols", "rmt.tx_wait_done", "rmt.tx_deinit", "rmt.rx_init", "rmt.rx_on_received", "rmt.rx_start", "rmt.rx_stop", "rmt.rx_read", "rmt.rx_deinit", "adc.read", "adc.get_resolution", "adc.set_reference", "adc.get_reference", "adc.read_voltage", "dac.write", "interrupt.attach", "interrupt.detach", "tone.play", "tone.stop", "timing.delay", "timing.delay_microseconds", "timing.millis", "timing.micros", "timing.free_heap", "timing.set_interval", "timing.set_timeout", "timing.clear_interval", "timing.clear_timeout", "power.deep_sleep", "power.light_sleep", "power.set_cpu_frequency", "power.deep_sleep_pin", "i2c.begin", "i2c.end", "i2c.set_clock", "i2c.begin_transmission", "i2c.write", "i2c.write_bytes", "i2c.write_buffer", "i2c.read_buffer", "i2c.end_transmission", "i2c.request_from", "i2c.available", "i2c.read", "i2c.recover", "spi.begin", "spi.end", "spi.transfer", "spi.begin_transaction", "spi.end_transaction", "spi.set_mode", "spi.set_bit_order", "spi.cs_low", "spi.cs_high", "spi.read_buffer", "uart.begin", "uart.end", "uart.print", "uart.println", "uart.printf", "uart.write", "uart.read", "uart.peek", "uart.available", "uart.flush", "pulse.in", "pulse.in_long", "shift.out", "shift.in", "board.resolve", "wdt.enable", "wdt.reset", "wdt.disable", "snprintf.emit", "wifi.connect", "wifi.connect_start", "wifi.disconnect", "wifi.status", "wifi.is_connected", "wifi.local_ip", "wifi.rssi", "wifi.mac", "wifi.set_hostname", "wifi.set_static_ip", "wifi.set_auto_reconnect", "wifi.set_power_save", "wifi.set_tx_power", "wifi.on_event", "wifi.ap_start", "wifi.ap_stop", "wifi.ap_client_count", "wifi.ap_ip", "wifi.ap_set_channel", "wifi.ap_set_hidden", "wifi.ap_set_max_clients", "wifi.scan", "wifi.scan_start", "wifi.scan_done", "wifi.scan_count", "wifi.scan_ssid", "wifi.scan_rssi", "wifi.scan_encryption", "wifi.scan_channel", "wifi.save_credentials", "wifi.connect_saved", "wifi.clear_credentials", "wifi.wait_connected", "wifi.wait_disconnected", "http.begin", "http.reset", "http.set_header", "http.set_timeout", "http.set_max_body", "http.set_body", "http.set_insecure", "http.set_ca_cert", "http.send", "http.send_start", "http.done", "http.status", "http.ok", "http.body", "http.content_length", "http.response_header", "ble.server_begin", "ble.advertise_start", "ble.advertise_stop", "ble.add_service", "ble.add_char", "ble.on_read", "ble.on_write", "ble.on_connect", "ble.on_disconnect", "ble.notify", "ble.is_connected", "ble.client_count", "ble.set_name", "ble.until_connected", "ble.until_connected_start", "ble.set_tx_power", "ble.status", "preferences.begin", "preferences.end", "preferences.clear", "preferences.remove", "preferences.put_int", "preferences.get_int", "preferences.put_uint", "preferences.get_uint", "preferences.put_bool", "preferences.get_bool", "preferences.put_float", "preferences.get_float", "preferences.put_string", "preferences.get_string", "raw"];

package/dist/api/shared/hal-op-ir.js

@@ -15,4 +15,98 @@
 // the MCU package's pin mapping. The `pin` field provides backward
 // compatibility as a legacy framework pin number.
 // ---------------------------------------------------------------------------
-export {};
+/**
+ * Runtime registry of every HAL operation discriminator, parallel to
+ * {@link DISPLAY_OPERATION_KINDS}. Lets tests and the manifest validator
+ * enumerate HAL op kinds without parsing types (which are erased at runtime).
+ * Keep in sync with {@link HALOpIR} above.
+ *
+ * Note: `display.*` ops are NOT listed here — they live in
+ * {@link DISPLAY_OPERATION_KINDS} in `display-op-ir.ts`. The manifest
+ * validator imports both and unions them when probing display ops.
+ */
+export const HAL_OPERATION_KINDS = [
+    // GPIO
+    'gpio.write', 'gpio.read', 'gpio.toggle', 'gpio.set_mode',
+    // PWM
+    'pwm.write', 'pwm.get_frequency', 'pwm.get_resolution',
+    // RMT
+    'rmt.tx_init', 'rmt.tx_write_bytes', 'rmt.tx_write_symbols',
+    'rmt.tx_wait_done', 'rmt.tx_deinit',
+    'rmt.rx_init', 'rmt.rx_on_received', 'rmt.rx_start',
+    'rmt.rx_stop', 'rmt.rx_read', 'rmt.rx_deinit',
+    // ADC
+    'adc.read', 'adc.get_resolution', 'adc.set_reference',
+    'adc.get_reference', 'adc.read_voltage',
+    // DAC
+    'dac.write',
+    // Interrupts
+    'interrupt.attach', 'interrupt.detach',
+    // Tone
+    'tone.play', 'tone.stop',
+    // Timing
+    'timing.delay', 'timing.delay_microseconds', 'timing.millis',
+    'timing.micros', 'timing.free_heap', 'timing.set_interval',
+    'timing.set_timeout', 'timing.clear_interval', 'timing.clear_timeout',
+    // Power
+    'power.deep_sleep', 'power.light_sleep', 'power.set_cpu_frequency', 'power.deep_sleep_pin',
+    // I2C
+    'i2c.begin', 'i2c.end', 'i2c.set_clock', 'i2c.begin_transmission',
+    'i2c.write', 'i2c.write_bytes', 'i2c.write_buffer', 'i2c.read_buffer',
+    'i2c.end_transmission', 'i2c.request_from', 'i2c.available', 'i2c.read',
+    'i2c.recover',
+    // SPI
+    'spi.begin', 'spi.end', 'spi.transfer', 'spi.begin_transaction',
+    'spi.end_transaction', 'spi.set_mode', 'spi.set_bit_order',
+    'spi.cs_low', 'spi.cs_high', 'spi.read_buffer',
+    // UART
+    'uart.begin', 'uart.end', 'uart.print', 'uart.println', 'uart.printf',
+    'uart.write', 'uart.read', 'uart.peek', 'uart.available', 'uart.flush',
+    // Pulse
+    'pulse.in', 'pulse.in_long',
+    // Shift
+    'shift.out', 'shift.in',
+    // Board
+    'board.resolve',
+    // Watchdog timer
+    'wdt.enable', 'wdt.reset', 'wdt.disable',
+    // Snprintf
+    'snprintf.emit',
+    // WiFi
+    'wifi.connect', 'wifi.connect_start', 'wifi.disconnect', 'wifi.status',
+    'wifi.is_connected', 'wifi.local_ip', 'wifi.rssi', 'wifi.mac',
+    'wifi.set_hostname', 'wifi.set_static_ip', 'wifi.set_auto_reconnect',
+    'wifi.set_power_save', 'wifi.set_tx_power', 'wifi.on_event',
+    'wifi.ap_start', 'wifi.ap_stop', 'wifi.ap_client_count', 'wifi.ap_ip',
+    'wifi.ap_set_channel', 'wifi.ap_set_hidden', 'wifi.ap_set_max_clients',
+    'wifi.scan', 'wifi.scan_start', 'wifi.scan_done', 'wifi.scan_count',
+    'wifi.scan_ssid', 'wifi.scan_rssi', 'wifi.scan_encryption',
+    'wifi.scan_channel', 'wifi.save_credentials', 'wifi.connect_saved',
+    'wifi.clear_credentials', 'wifi.wait_connected', 'wifi.wait_disconnected',
+    // HTTP
+    'http.begin', 'http.reset', 'http.set_header', 'http.set_timeout',
+    'http.set_max_body', 'http.set_body', 'http.set_insecure',
+    'http.set_ca_cert', 'http.send', 'http.send_start', 'http.done',
+    'http.status', 'http.ok', 'http.body', 'http.content_length',
+    'http.response_header',
+    // BLE (NimBLE GATT peripheral)
+    'ble.server_begin', 'ble.advertise_start', 'ble.advertise_stop',
+    'ble.add_service', 'ble.add_char',
+    'ble.on_read', 'ble.on_write', 'ble.on_connect', 'ble.on_disconnect', 'ble.notify',
+    'ble.is_connected', 'ble.client_count', 'ble.set_name',
+    'ble.until_connected', 'ble.until_connected_start',
+    'ble.set_tx_power', 'ble.status',
+    // Preferences (NVS)
+    'preferences.begin', 'preferences.end', 'preferences.clear', 'preferences.remove',
+    'preferences.put_int', 'preferences.get_int',
+    'preferences.put_uint', 'preferences.get_uint',
+    'preferences.put_bool', 'preferences.get_bool',
+    'preferences.put_float', 'preferences.get_float',
+    'preferences.put_string', 'preferences.get_string',
+    // Raw passthrough
+    'raw',
+];
+// Compile-time exhaustiveness check: every HAL_OPERATION_KINDS entry must
+// be a valid HALOpIR["operation"]. If you add an op to the const but not the
+// union (or vice versa), this assignment fails to type-check.
+const _halOpKindsExhaustive = [...HAL_OPERATION_KINDS];

package/dist/api/shared/index.d.ts

@@ -3,11 +3,15 @@ export type { CppTypeIR, CppTypeKind, CppPrimitiveName, CppFormatKind, } from '.
 export { parseCppType, renderCppType, splitTemplateArgs, isPointer, isReference, isContainer, isVector, isMap, isSet, isTuple, isVariant, isStdFunction, isStaticArray, isCArray, isStringLike, isPrimitive, bareType, elementOf, formatKindOf, CppTypeIR as cppTypeIRBuilder, parsedIsPointer, parsedIsStringLike, parsedIsPrimitive, parsedIsContainer, parsedIsVector, parsedIsMap, parsedIsSet, parsedIsTuple, parsedIsVariant, parsedIsStaticArray, parsedIsStdString, parsedElementOf, parsedElementString, parsedBareString, parsedBareType, collectNamedTypes, parsedCollectNamedTypes, needsCStrForStringLike, parsedIsPlainStructType, } from './cpp-type-ir.js';
 export type { ExpressionIR, StatementIR, ProgramIR, ImportIR, ReExportIR, CallExpressionIR, SuperCallIR, VariableDeclarationIR, AssignmentIR, UpdateIR, ReturnIR, WhileIR, IfIR, ForIR, ForOfIR, ForInIR, BreakIR, ContinueIR, DoWhileIR, SwitchIR, CaseIR, TryIR, ThrowIR, LabeledIR, BlockIR, HALOpStatementIR, FunctionIR, StructDefIR, EnumIR, ClassFieldIR, ClassConstructorIR, ClassMethodIR, ClassGetterIR, ClassSetterIR, ClassIR, InterfaceIR, TypeAliasIR, NamespaceIR, PeripheralUsageIR, RegisterBitFieldIR, RegisterClassIR, ParameterIR, CppType, } from './ir.js';
 export type { HALOpIR, HALOperationKind, } from './hal-op-ir.js';
+export { HAL_OPERATION_KINDS } from './hal-op-ir.js';
 export type { DisplayInitOp, DisplayFillRectOp, DisplayDrawTextOp, DisplayDrawRectOp, DisplayFlushOp, DisplayHALOp, } from './display-op-ir.js';
 export { DISPLAY_OPERATION_KINDS } from './display-op-ir.js';
 export type { PlatformGraphicsStrategy, GraphicsCapacity } from './graphics-strategy.js';
-export type { DisplayProfile, DisplayConfig, DisplaySize, TouchProfile, TouchLibrary, ResolvedDisplay } from './display-profile.js';
+export type { DisplayProfile, DisplayConfig, DisplaySize, TouchProfile, TouchLibrary, TouchAdapterCodegen, ResolvedDisplay } from './display-profile.js';
 export { effectiveDisplaySize, normalizeDisplayRotation, resolveDisplayProfile, resolveScrollConfig, DEFAULT_SCROLL_CANVAS_BUDGET_BYTES } from './display-profile.js';
+export { GLCDFONT_BYTES, renderGlcdfontArray } from './glcdfont.js';
+export type { DisplayAdapterCode, DisplayAdapterGenerator } from './display-adapter.js';
+export { resolveNativeDisplayOp } from './native-display-op-resolver.js';
 export type { DisplayCapabilities, DisplayFeatureFlags, NativeFormat, RefreshModel, PartialRefreshScope, } from './display-capabilities.js';
 export { defaultTftCapabilities, deriveCapabilities } from './display-capabilities.js';
 export type { BoardConstants } from './board-resolver.js';
@@ -24,3 +28,9 @@ export { isStringEnum } from './ir-declarations.js';
 export type { AsyncRuntimeConfig } from './async-types.js';
 export { generatePromiseRuntime } from './promise-runtime.js';
 export { generateStaticAsyncRuntime } from './async-runtime-static.js';
+export { FrameworkManifestSchema, defineFrameworkManifest, HAL_CATEGORIES, POLYFILL_BACKED_OPS, } from './framework-manifest.js';
+export type { FrameworkManifest, HalCategory, } from './framework-manifest.js';
+export { KNOWN_FRAMEWORK_PACKAGES, loadFrameworkManifest, } from './framework-manifest-registry.js';
+export type { KnownFrameworkPackage } from './framework-manifest-registry.js';
+export { validateFrameworkManifest } from './validate-framework-manifest.js';
+export type { ManifestValidationContext, ManifestValidationResult, ManifestValidationError, ManifestValidationWarning, } from './validate-framework-manifest.js';

package/dist/api/shared/index.js

@@ -4,8 +4,16 @@
 // Re-exports all shared types for use by CLI and framework packages.
 // ---------------------------------------------------------------------------
 export { parseCppType, renderCppType, splitTemplateArgs, isPointer, isReference, isContainer, isVector, isMap, isSet, isTuple, isVariant, isStdFunction, isStaticArray, isCArray, isStringLike, isPrimitive, bareType, elementOf, formatKindOf, CppTypeIR as cppTypeIRBuilder, parsedIsPointer, parsedIsStringLike, parsedIsPrimitive, parsedIsContainer, parsedIsVector, parsedIsMap, parsedIsSet, parsedIsTuple, parsedIsVariant, parsedIsStaticArray, parsedIsStdString, parsedElementOf, parsedElementString, parsedBareString, parsedBareType, collectNamedTypes, parsedCollectNamedTypes, needsCStrForStringLike, parsedIsPlainStructType, } from './cpp-type-ir.js';
+export { HAL_OPERATION_KINDS } from './hal-op-ir.js';
 export { DISPLAY_OPERATION_KINDS } from './display-op-ir.js';
 export { effectiveDisplaySize, normalizeDisplayRotation, resolveDisplayProfile, resolveScrollConfig, DEFAULT_SCROLL_CANVAS_BUDGET_BYTES } from './display-profile.js';
+// Shared 5x7 glcdfont table (Adafruit public-domain source). Consumed by
+// the SDL preview adapter and the native CuttlefishGFX runtime-header slice.
+export { GLCDFONT_BYTES, renderGlcdfontArray } from './glcdfont.js';
+// Native display-op resolver — lowers display.* HAL ops into calls against
+// the adapter surface (display_init / display_targetFillRect / etc.). Used
+// by NativeAVRStrategy and Esp32Strategy's resolveDisplayOp overrides.
+export { resolveNativeDisplayOp } from './native-display-op-resolver.js';
 export { defaultTftCapabilities, deriveCapabilities } from './display-capabilities.js';
 export { getStdLibSupport, DEFAULT_STDLIB_SUPPORT } from './polyfill-types.js';
 export { parseCompileErrors, collectCppFiles } from './toolchain-types.js';
@@ -19,3 +27,9 @@ export { isStringEnum } from './ir-declarations.js';
 export { generatePromiseRuntime } from './promise-runtime.js';
 // Heap-free static async runtime generator (AVR / megaavr / no-<vector> targets)
 export { generateStaticAsyncRuntime } from './async-runtime-static.js';
+// Framework manifest schema + helper
+export { FrameworkManifestSchema, defineFrameworkManifest, HAL_CATEGORIES, POLYFILL_BACKED_OPS, } from './framework-manifest.js';
+// Framework manifest discovery
+export { KNOWN_FRAMEWORK_PACKAGES, loadFrameworkManifest, } from './framework-manifest-registry.js';
+// Framework manifest validator
+export { validateFrameworkManifest } from './validate-framework-manifest.js';

package/dist/api/shared/native-display-op-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { DisplayHALOp } from "./display-op-ir.js";
+/**
+ * Resolve a display HAL op to a call into the native adapter surface
+ * (display_init / display_targetFillRect / etc.). Returns undefined for ops
+ * this resolver does not handle.
+ */
+export declare function resolveNativeDisplayOp(op: DisplayHALOp): {
+    code?: string;
+    expression?: string;
+} | undefined;