@pi-r/chrome 0.11.2 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-r/chrome",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "Chrome document constructor for E-mc.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -20,10 +20,10 @@
   "license": "MIT",
   "homepage": "https://github.com/anpham6/pi-r#readme",
   "dependencies": {
-    "@e-mc/cloud": "^0.13.9",
-    "@e-mc/core": "^0.13.9",
-    "@e-mc/document": "^0.13.9",
-    "@e-mc/types": "^0.13.9",
+    "@e-mc/cloud": "^0.14.0",
+    "@e-mc/core": "^0.14.0",
+    "@e-mc/document": "^0.14.0",
+    "@e-mc/types": "^0.14.0",
     "image-size": "^2.0.2"
   }
 }

package/types/index.d.ts

@@ -1,6 +1,7 @@
 import type { LocationUri, XmlTagNode } from '@e-mc/types/lib/squared';
 
 import type { DocumentConstructor, ICloud, IDocument, IFileManager } from '@e-mc/types/lib';
+import type { IFileThread } from '@e-mc/types/lib/asset';
 import type { DocumentAsset as IDocumentAsset } from '@e-mc/types/lib/document';
 import type { LogTime } from '@e-mc/types/lib/logger';
 import type { DbSourceDataType, DocumentComponentOption, DocumentComponent as IDocumentComponent, DocumentComponentOptions as IDocumentComponentOptions, DocumentDirectory as IDocumentDirectory, DocumentEval as IDocumentEval, DocumentModule as IDocumentModule, DocumentSettings as IDocumentSettings, DocumentUserSettings as IDocumentUserSettings } from '@e-mc/types/lib/settings';
@@ -17,6 +18,18 @@ export const enum PROPERTIES {
     SERVERROOT = '__serverroot__'
 }
 
+export const enum MIME {
+    HTML = 'text/html',
+    JS = 'application/javascript',
+    JS_TEXT = 'text/javascript',
+    CSS = 'text/css',
+    SVG = 'image/svg+xml',
+    TTF = 'font/ttf',
+    OTF = 'font/otf',
+    WOFF = 'font/woff',
+    WOFF2 = 'font/woff2'
+}
+
 interface DocumentDirectory extends IDocumentDirectory {
     template?: string;
     data?: string;
@@ -52,18 +65,30 @@ interface ChromeDocumentSettings extends IDocumentSettings<ChromeDocumentUserSet
 
 type OutputType = "useUnsafeReplace" | "productionRelease" | "productionIncremental" | "serverRootMapping" | "sanitizeFramework" | "templateMap" | "userAgentData";
 
+export interface ChromeExtensionOptions<T extends DocumentAsset = DocumentAsset> {
+    file?: T;
+}
+
+export interface ChromeExtensionCssOptions<T extends DocumentAsset = DocumentAsset> extends ChromeExtensionOptions<T> {
+    config: UserConfig;
+}
+
+export type ChromeExtension<T extends DocumentAsset = DocumentAsset> = (source: string, options: ChromeExtensionOptions<T>) => Promise<string | undefined>;
+export type ChromeExtensionCss<T extends DocumentAsset = DocumentAsset> = (source: string, options: ChromeExtensionCssOptions<T>) => Promise<string | undefined>;
+
 export interface FormatUri extends Partial<LocationUri> {
     dictionary?: string;
 }
 
-export interface FinalizeProcessing<T extends IFileManager<U>, U extends DocumentAsset = DocumentAsset> {
+export interface DocumentFinalize<T extends IFileManager<U>, U extends DocumentAsset> {
     readonly host: T;
     readonly startTime: LogTime;
-    readonly hashed: Set<DocumentAsset>;
+    readonly hashed: Set<U>;
     readonly contentMap: StringMap;
     readonly bufferMap: ObjectMap<Bufferable>;
     readonly cacheMiss: string[];
     readonly productionRelease: true | undefined;
+    getBuffer(item: U, localUri?: string): Bufferable | null;
 }
 
 export interface DocumentComponent<T = boolean> extends IDocumentComponent<T, T>, DocumentComponentExtended<T> {}
@@ -91,7 +116,7 @@ export interface UserConfig extends CssRuleData, Omit<DocumentOutput, OutputType
     useUnsafeCssReplace?: boolean;
 }
 
-export interface IChromeDocument<T extends IFileManager<U>, U extends DocumentAsset = DocumentAsset, V extends ICloud = ICloud<T>> extends IDocument<T, U, DocumentModule, DocumentComponent, DocumentComponentOption, V>, Pick<DocumentOutput, OutputType> {
+export interface IChromeDocument<T extends IFileManager<U>, U extends DocumentAsset, V extends ICloud = ICloud<T>> extends IDocument<T, U, DocumentModule, DocumentComponent, DocumentComponentOption, V>, Pick<DocumentOutput, OutputType> {
     htmlFile: U | null;
     cssFiles: U[];
     jsFiles: U[];
@@ -101,16 +126,20 @@ export interface IChromeDocument<T extends IFileManager<U>, U extends DocumentAs
     config: UserConfig;
     related: Map<U, Set<U>>;
     replaced: U[];
+    assets: U[];
     formatMap?: ObjectMap<FormatUri>;
+    using(data: IFileThread): Promise<void>;
     setElementSrc(file: U, element: IXmlElement, value: string): void;
     findDataValue(name: string): string | undefined;
-    setInlinedAttributes(processing: FinalizeProcessing<T, U>): void;
-    applyTransforms(processing: FinalizeProcessing<T, U>): Promise<void>;
-    rewriteHtml(processing: FinalizeProcessing<T, U>): Promise<void>;
-    setElementAttributes(processing: FinalizeProcessing<T, U>, domBase: IDomWriter): Promise<void>;
-    applyDataSource(processing: FinalizeProcessing<T, U>, domBase: IDomWriter): Promise<void>;
-    setProductionAttributes(processing: FinalizeProcessing<T, U>): void;
-    removeUnusedStyles(source: string, options?: UserConfig): string | undefined;
+    setInlinedAttributes(processing: DocumentFinalize<T, U>): void;
+    applyTransforms(processing: DocumentFinalize<T, U>): Promise<void>;
+    rewriteHtml(processing: DocumentFinalize<T, U>): Promise<void>;
+    setElementAttributes(processing: DocumentFinalize<T, U>, domBase: IDomWriter): Promise<void>;
+    applyDataSource(processing: DocumentFinalize<T, U>, domBase: IDomWriter): Promise<void>;
+    setProductionAttributes(processing: DocumentFinalize<T, U>): void;
+    createHash(processing: DocumentFinalize<T, U>, file: U, hash: string): void;
+    transformJs(processing: DocumentFinalize<T, U>, file: U, source: string): Promise<string | undefined>;
+    transformCss(processing: DocumentFinalize<T, U>, file: U, source: string): Promise<string | undefined>;
     removeServerRoot(value: string): string;
     replaceContent(source: string, match: RegExpExecArray | string, mimeType?: string): string | undefined;
     cloudInit(state: CloudScopeOrigin<T, U, V>): void;
@@ -127,7 +156,7 @@ export interface IChromeDocument<T extends IFileManager<U>, U extends DocumentAs
     get settings(): ChromeDocumentSettings;
 }
 
-export interface ChromeDocumentConstructor<T extends IFileManager<U>, U extends DocumentAsset = DocumentAsset> extends ConstructorDerived<DocumentConstructor<T, U>> {
+export interface ChromeDocumentConstructor<T extends IFileManager<U>, U extends DocumentAsset> extends ConstructorDerived<DocumentConstructor<T, U>> {
     INTERNAL_ASSIGNUUID: string;
     INTERNAL_SERVERROOT: string;
     readonly prototype: IChromeDocument<T, U>;

package/types/squared.d.ts

@@ -47,6 +47,7 @@ export interface DocumentOutput {
     serverRootMapping?: StringMap;
     useOriginalHtmlPage?: boolean | string;
     useUnsafeReplace?: ArrayOf<"html" | "css"> | boolean;
+    /** @deprecated */
     useSessionCache?: boolean;
     stripCommentsAndCDATA?: boolean | string;
     normalizeHtmlOutput?: boolean | string;
@@ -60,7 +61,7 @@ export interface DocumentOutput {
 
 export interface RequestData extends IRequestData<ChromeAsset>, Readonly<DocumentOutput>, Readonly<CssRuleData> {}
 
-export interface ChromeAsset extends FileAsset, AttributeAction, ElementAction, MetadataAction<PlainObject>, UploadAction, HashAction, ExcludeAction, ImportAction<ImportFrom[] | boolean>, FromAction, WorkerAction {
+export interface ChromeAsset extends FileAsset, AttributeAction, ElementAction, MetadataAction, UploadAction, HashAction, ExcludeAction, ImportAction<ImportFrom[] | boolean>, FromAction, WorkerAction {
     preserve?: boolean;
     static?: boolean;
     editing?: boolean;

package/util.d.ts

@@ -0,0 +1,20 @@
+import { spliceString, splitEnclosing } from '@e-mc/document/util';
+
+interface ReplaceMatchOptions {
+    pattern?: RegExp;
+    trimLeading?: boolean;
+    trimTrailing?: boolean;
+}
+
+export const PATTERN_PARENTHESIS: string;
+
+export function replaceMatch(match: RegExpMatchArray, source: string, pattern: RegExp): string;
+export function replaceMatch(match: RegExpMatchArray, source: string, content: number | string, options: ReplaceMatchOptions): string;
+export function replaceMatch(match: RegExpMatchArray, source: string, content?: number | string, pattern?: RegExp): string;
+export function isSpace(ch: string): boolean;
+export function getNewlineString(leading: string, trailing: string, newline?: string): string;
+
+export function spliceSource(source: string, startIndex: number, endIndex: number, pattern: RegExp, leading?: string, trailing?: string, content?: string): string;
+export function findClosingIndex<T extends "{" | "(", U extends T extends infer V ? V extends "{" ? [number, string] : number : never>(source: string, lastIndex: number, char: T): U;
+
+export { spliceString, splitEnclosing };

package/util.js

@@ -0,0 +1,49 @@
+"use strict";
+
+const { DomWriter } = require('@e-mc/document/parse/dom');
+const { spliceString, splitEnclosing } = require('@e-mc/document/util');
+const isSpace = DomWriter.isSpace.bind(DomWriter);
+const PATTERN_PARENTHESIS = '(?:,[^()]+(?=\\))|[^()]|\\([^()]*\\(+|\\([^()]*\\)|(?:\\)[^()]+)?\\)*?)+';
+const replaceMatch = DomWriter.replaceMatch.bind(DomWriter);
+const getNewlineString = DomWriter.getNewlineString.bind(DomWriter);
+function spliceSource(source, startIndex, endIndex, pattern, leading = '', trailing = '', content = '') {
+    if (leading || trailing) {
+        content += getNewlineString(leading, trailing);
+    }
+    return spliceString(source, startIndex, endIndex, content, pattern);
+}
+function findClosingIndex(source, lastIndex, char) {
+    const pattern = char === '{' ? /[{}]/g : /[()]/g;
+    pattern.lastIndex = lastIndex;
+    let opened = 1, closed = 0, endIndex = -1, trailing = '', match;
+    while (match = pattern.exec(source)) {
+        if (match[0] === char) {
+            ++opened;
+        }
+        else if (++closed === opened) {
+            if (char === '(') {
+                return match.index;
+            }
+            endIndex = match.index + 1;
+            let ch;
+            while (isSpace(ch = source[endIndex])) {
+                trailing += ch;
+                ++endIndex;
+                if (ch === '\n') {
+                    break;
+                }
+            }
+            break;
+        }
+    }
+    return [endIndex, trailing];
+}
+
+exports.PATTERN_PARENTHESIS = PATTERN_PARENTHESIS;
+exports.findClosingIndex = findClosingIndex;
+exports.getNewlineString = getNewlineString;
+exports.isSpace = isSpace;
+exports.replaceMatch = replaceMatch;
+exports.spliceSource = spliceSource;
+exports.spliceString = spliceString;
+exports.splitEnclosing = splitEnclosing;