pxt-core 13.2.14 → 13.2.16

package/built/backendutils.d.ts

@@ -1,5 +1,6 @@
 /// <reference path="../localtypings/pxtarget.d.ts" />
 /// <reference path="../localtypings/dompurify.d.ts" />
+/// <reference path="../localtypings/pxtpackage.d.ts" />
 declare namespace pxt {
     interface TelemetryEventOptions {
         interactiveConsent: boolean;
@@ -57,6 +58,7 @@ declare namespace ts.pxtc {
 }
 import pxtc = ts.pxtc;
 declare namespace ts.pxtc.Util {
+    function contains(str: string, contains: string): boolean;
     function assert(cond: boolean, msg?: string): void;
     function flatClone<T extends Object>(obj: T): T;
     function clone<T>(v: T): T;
@@ -107,6 +109,38 @@ declare namespace ts.pxtc.Util {
     function deepEqual(a: any, b: any): boolean;
 }
 declare const lf: typeof pxtc.Util.lf;
+declare namespace ts.pxtc {
+    /**
+     * atob replacement
+     * @param s
+     */
+    let decodeBase64: (s: string) => string;
+    /**
+     * bota replacement
+     * @param s
+     */
+    let encodeBase64: (s: string) => string;
+}
+declare namespace ts.pxtc.Util {
+    function iterMap<T>(m: pxt.Map<T>, f: (k: string, v: T) => void): void;
+    function values<T>(m: pxt.Map<T>): T[];
+    function pushRange<T>(trg: T[], src: ArrayLike<T>): void;
+    function concatArrayLike<T>(arrays: ArrayLike<ArrayLike<T>>): T[];
+    function concat<T>(arrays: T[][]): T[];
+    function jsonMergeFrom(trg: any, src: any): void;
+    function jsonCopyFrom<T>(trg: T, src: T): void;
+    function jsonFlatten(v: any): pxt.Map<any>;
+    function jsonUnFlatten(v: pxt.Map<any>): any;
+    function strcmp(a: string, b: string): 1 | -1 | 0;
+    function endsWith(str: string, suffix: string): boolean;
+    function startsWith(str: string, prefix: string): boolean;
+    function toUTF8(str: string, cesu8?: boolean): string;
+    function toUTF8Array(s: string): Uint8Array;
+}
+declare namespace pxt {
+    export import U = pxtc.Util;
+    export import Util = pxtc.Util;
+}
 declare namespace pxt.docs {
     type MarkedRenderFunction = (src: string, options?: any) => string;
     interface MarkedRenderer {
@@ -188,3 +222,89 @@ declare namespace pxt.docs {
     export function hydrateYouTubeEmbeds(content: HTMLElement, tickEvent: boolean): void;
     export {};
 }
+declare namespace ts.pxtc.BrowserImpl {
+    function sha256buffer(buf: Uint8Array): string;
+}
+declare namespace Measurements {
+    const TutorialInfoDbSetAsync = "tutorial info db setAsync";
+    const ReloadAppTargetVariant = "reloadAppTargetVariant";
+    const Sha256Buffer = "sha256buffer";
+    const WebworkerRecvHandler = "webworker recvHandler";
+    const NetworkRequest = "network.request";
+}
+declare namespace pxt.packageUtils {
+    function getVersionProtocol(version: string): string;
+    function isVariantDisabled(config: PackageConfig, variant: string): boolean;
+    function getConfigDependencies(config: PackageConfig, includeTests: boolean, includeCpp: boolean, isTestDependencyAvailable: (id: string, version: string) => boolean): Map<string>;
+    /** Evaluates fileDependencies with && taking precedence over ||, without reading target or package globals. */
+    function evaluateDependencyCondition(condition: string, target: Pick<AppTarget, "id" | "platformid">, hasDependency: (id: string) => boolean, onInvalidCondition: (condition: string) => void): boolean;
+    function getConfigFiles(config: PackageConfig, includeTests: boolean, target: Pick<AppTarget, "id" | "platformid">, hasDependency: (id: string) => boolean, onInvalidCondition: (condition: string, filename: string) => void): string[];
+}
+declare namespace pxt {
+    /** Resolves compile defaults and a variant without modifying the supplied target. */
+    function getAppTargetVariant(target: TargetBundle, variant: string): TargetBundle;
+    function patchCompileTarget(target: AppTarget): void;
+}
+declare namespace ts.pxtc.Util {
+    function cloneTargetBundle(target: pxt.TargetBundle): pxt.TargetBundle;
+    function cloneApis(byQName: pxt.Map<pxtc.SymbolInfo>): pxt.Map<SymbolInfo>;
+    function cloneSymbolInfo(sym: pxtc.SymbolInfo): pxtc.SymbolInfo;
+}
+declare namespace ts.pxtc {
+    function parseCommentString(cmt: string): CommentAttrs;
+    function updateBlockDef(attrs: CommentAttrs): void;
+    function parseBlockDefinition(def: string): ParsedBlockDef;
+}
+declare namespace pxt.github {
+    interface ParsedRepo {
+        owner?: string;
+        project?: string;
+        slug: string;
+        fullName: string;
+        tag?: string;
+        fileName?: string;
+    }
+    function parseRepoId(repo: string): ParsedRepo;
+    function stringifyRepo(p: ParsedRepo, ignoreCase?: boolean): string;
+    function join(...parts: string[]): string;
+}
+declare namespace ts.pxtc {
+    const NATIVE_TYPE_THUMB = "thumb";
+    const NATIVE_TYPE_VM = "vm";
+    function emptyExtInfo(compileService: pxt.TargetCompileService): ExtensionInfo;
+}
+declare namespace pxt.cpp {
+    function nsWriter(nskw?: string): {
+        setNs: (ns: string, over?: string) => void;
+        clear: () => void;
+        write: (s: string) => void;
+        incrIndent: () => void;
+        decrIndent: () => void;
+        finish: () => string;
+    };
+    function parseCppInt(v: string): number;
+    class PkgConflictError extends Error {
+        pkg0Id: string;
+        pkg1Id: string;
+        settingName: string;
+        isUserError: boolean;
+        isVersionConflict: boolean;
+        constructor(msg: string);
+    }
+    interface ExtensionInfoHost {
+        cache: Map<pxtc.ExtensionInfo>;
+        logger: Pick<Logger, "debug" | "log">;
+        perf: {
+            measureStart(name: string): void;
+            measureEnd(name: string): void;
+        };
+    }
+    /**
+     * Generates native extension files from pxt.json and project files, with dependencies
+     * under pxt_modules/<directory>/. Dependencies resolve by directory, pxt.json name,
+     * or their prefix before "---".
+     * The target must not have variant overrides applied.
+     * @example getExtensionInfo({ "pxt.json": config, "main.cpp": source }, target, "v2", host)
+     */
+    function getExtensionInfo(files: Map<string>, target: TargetBundle, variant: string, host: ExtensionInfoHost): pxtc.ExtensionInfo;
+}