@typecad/cuttlefish 1.0.0-alpha.14 → 1.0.0-alpha.16

package/dist/frameworks/native/strategy.d.ts

@@ -0,0 +1,97 @@
+import type { PlatformStrategy, ProgramIR, Diagnostic, PlatformContext, RuntimePolyfillIR, StdLibSupport, AsyncRuntimeConfig, GraphicsCapacity, DisplayHALOp } from '../../api/shared/index.js';
+export declare class NativeStrategy implements PlatformStrategy {
+    readonly id = "native";
+    forcedIncludes(program: ProgramIR, ctx?: PlatformContext): string[];
+    symbolAliases(): Record<string, string>;
+    shimLines(program: ProgramIR, ctx?: PlatformContext): string[];
+    profileDiagnostics(): Diagnostic[];
+    sourceExtension(): string;
+    entrypointFunctionName(): string;
+    requiresLoopFunction(): boolean;
+    overrideBaseName(originalBaseName: string): string;
+    effectiveEmitMode(requestedMode: string): string;
+    normalizeCppType(typeName: string): string;
+    defaultNumericType(compliance?: {
+        isBanned(ruleId: string): boolean;
+    }): string;
+    mapReturnType(functionName: string, returnType: string): string;
+    isStringLikeType(cppType: string): boolean;
+    isPointerType(cppType: string): boolean;
+    mapFunctionName(originalName: string): string;
+    normalizeRawExpression(value: string): string;
+    nullValue(): string;
+    wrapStringConcat(): string | undefined;
+    wrapStringObject(value: string): string;
+    useSnprintfForStrings(): boolean;
+    promoteDivisionToDouble(): boolean;
+    renameEnumMember(_enumName: string, memberName: string): string;
+    private _largeEnumNames;
+    setLargeEnumNames(names: ReadonlySet<string>): void;
+    enumCastType(enumName: string): string | undefined;
+    renderBoardDefinitionAccess(): string | undefined;
+    /**
+     * Native lowers array literals to std::vector (not __tc_StaticArray), so the
+     * structural array-method lowering must use the std::vector/__tc_* helper form
+     * (.push_back, __tc_pop) rather than the StaticArray wrapper's .push/.pop.
+     * Embedded/generic targets promote literals to StaticArray and default to true.
+     */
+    promotesArrayLiteralsToStaticArray(): boolean;
+    renderThrow(valueExpr: string): string;
+    objectFieldInitializer(): string | undefined;
+    overrideClassFieldType(_fieldName: string, normalizedType: string): string;
+    reservedNames(): ReadonlySet<string>;
+    passthroughMacroNames(): ReadonlySet<string>;
+    apiReservedEnumNames(): ReadonlySet<string>;
+    apiReservedEnumGuard(): string;
+    ambientTypeDeclarations(): string[];
+    needsIostream(): boolean;
+    needsStdString(): boolean;
+    needsStdVector(): boolean;
+    needsStdExcept(): boolean;
+    needsStdFunction(): boolean;
+    mathHeader(): string;
+    cstringHeader(): string;
+    needsLargeEnumUnderlying(): boolean;
+    renameStructField(fieldName: string): string;
+    structFieldInitializer(): string | undefined;
+    getAsyncRuntimeConfig(): AsyncRuntimeConfig;
+    asyncLoopInjection(taskVarNames: string[], config: AsyncRuntimeConfig): string[];
+    asyncLoopInjection(taskVarNames: string[], hasPromiseRuntime: boolean, hasTimers: boolean): string[];
+    asyncDriverFunctionName(): string;
+    shouldSkipTypeAlias(): boolean;
+    emitDiagnostics(): Diagnostic[];
+    currentTimeMillis(): string;
+    asyncQueueCapacity(): number;
+    outputSubdirectory(_baseName: string): string;
+    generateHeaderFile(): boolean;
+    enumApiGuard(_enumName: string): {
+        open: string;
+        close: string;
+    } | undefined;
+    getStdLibSupport(_architecture?: string): StdLibSupport;
+    nativePolyfills(): Set<string>;
+    generateNativePolyfills(program?: ProgramIR): RuntimePolyfillIR[];
+    resolveDisplayOp(op: DisplayHALOp): {
+        code?: string;
+        expression?: string;
+    } | undefined;
+    hostEventLoop(): {
+        flagName: string;
+        continueCondition: string;
+        preIteration: string;
+        postIteration: string;
+    };
+    supportedDisplayDrivers(): ReadonlySet<string>;
+    modelsGpio(): boolean;
+    readDigitalPin(_pin: string): string;
+    readAnalogPin(_pin: string): string;
+    writeDigitalPin(_pin: string, _val: string): string;
+    setPinMode(_pin: string, _mode: string): string;
+    delayMs(_ms: string): string;
+    delayMicroseconds(_us: string): string;
+    halCallNames(): ReadonlySet<string>;
+    isHalCall(_name: string): boolean;
+    analogReadCallNames(): ReadonlySet<string>;
+    colorFormat(): "rgb565" | "rgb666" | "rgb888" | "mono";
+    graphicsCapacity(): GraphicsCapacity;
+}