@angular-wave/angular.ts 0.7.7 → 0.8.0

package/@types/shared/url-utils/url-utils.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @param {import("./interface.js").ResolvableUrl} url
+ * @return {import("./interface.js").ParsedUrl}
+ */
+export function urlResolve(
+  url: import("./interface.js").ResolvableUrl,
+): import("./interface.js").ParsedUrl;
+/**
+ * Parse a request URL and determine whether this is a same-origin request as the application
+ * document.
+ *
+ * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
+ * or a parsed URL object.
+ * @returns {boolean} Whether the request is for the same origin as the application document.
+ */
+export function urlIsSameOrigin(
+  requestUrl: import("./interface.js").ResolvableUrl,
+): boolean;
+/**
+ * Parse a request URL and determine whether it is same-origin as the current document base URL.
+ *
+ * Note: The base URL is usually the same as the document location (`location.href`) but can
+ * be overriden by using the `<base>` tag.
+ *
+ * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
+ * or a parsed URL object.
+ * @returns {boolean} Whether the URL is same-origin as the document base URL.
+ */
+export function urlIsSameOriginAsBaseUrl(
+  requestUrl: import("./interface.js").ResolvableUrl,
+): boolean;
+/**
+ * Create a function that can check a URL's origin against a list of allowed/trusted origins.
+ * The current location's origin is implicitly trusted.
+ *
+ * @param {string[]} trustedOriginUrls - A list of URLs (strings), whose origins are trusted.
+ *
+ * @returns {(url: import("./interface.js").ResolvableUrl) => boolean } - A function that receives a URL (string or parsed URL object) and returns
+ *     whether it is of an allowed origin.
+ */
+export function urlIsAllowedOriginFactory(
+  trustedOriginUrls: string[],
+): (url: import("./interface.js").ResolvableUrl) => boolean;
+/**
+ * Determine if two URLs share the same origin.
+ *
+ * @param {import("./interface.js").ResolvableUrl} url1 - First URL to compare as a string or a normalized URL in the form of
+ *     a dictionary object returned by `urlResolve()`.
+ * @param {import("./interface.js").ResolvableUrl} url2 - Second URL to compare as a string or a normalized URL in the form
+ *     of a dictionary object returned by `urlResolve()`.
+ *
+ * @returns {boolean} - True if both URLs have the same origin, and false otherwise.
+ */
+export function urlsAreSameOrigin(
+  url1: import("./interface.js").ResolvableUrl,
+  url2: import("./interface.js").ResolvableUrl,
+): boolean;
+/**
+ * Removes a trailing hash ('#') from the given URL if it exists.
+ *
+ * @param {string} url
+ * @returns {string}
+ */
+export function trimEmptyHash(url: string): string;

package/@types/shared/utils.d.ts

@@ -196,11 +196,6 @@ export function baseExtend(dst: any, objs: any, deep: any): any;
  * @returns {Object} Reference to `dst`.
  */
 export function extend(dst: any, ...src: any[]): any;
-/**
- * @param {string} str
- * @returns {number}
- */
-export function toInt(str: string): number;
 /**
  * @param {any} num
  * @returns {boolean}
@@ -404,8 +399,9 @@ export function tryDecodeURIComponent(value: string): string | void;
  *    unreserved    = ALPHA / DIGIT / "-" / "." / "_" / "~"
  *    sub-delims    = "!" / "$" / "&" / "'" / "(" / ")"
  *                     / "*" / "+" / "," / ";" / "="
+ * @param {string} val
  */
-export function encodeUriSegment(val: any): string;
+export function encodeUriSegment(val: string): string;
 /**
  * This method is intended for encoding *key* or *value* parts of query component. We need a custom
  * method because encodeURIComponent is too aggressive and encodes stuff that doesn't have to be
@@ -533,6 +529,48 @@ export function hasOwn(obj: object, key: string | number | symbol): boolean;
  * @returns {Function} A new function that will call `fn` only once.
  */
 export function callBackOnce(fn: Function): Function;
+/**
+ * Wraps a function so it will only be called starting from the second invocation.
+ * The first call does nothing and returns undefined.
+ *
+ * @param {Function} fn - The function to wrap.
+ * @returns {Function} A new function that will skip the first call.
+ */
+export function callBackAfterFirst(fn: Function): Function;
+/**
+ * Delays execution for a specified number of milliseconds.
+ *
+ * @param {number} [t=0] - The number of milliseconds to wait. Defaults to 0.
+ * @returns {Promise<void>} A promise that resolves after the delay.
+ */
+export function wait(t?: number): Promise<void>;
+/**
+ * Checks if a given string starts with a specified substring.
+ *
+ * This is a simple polyfill-like function that mimics the behavior of
+ * `String.prototype.startsWith` without using the built-in method.
+ *
+ * @param {string} str - The full string to evaluate.
+ * @param {string} search - The substring to test against the beginning of `str`.
+ * @returns {boolean} `true` if `str` starts with `search`, otherwise `false`.
+ *
+ * @example
+ * startsWith("hello world", "hello");
+ * // returns true
+ *
+ * @example
+ * startsWith("hello world", "world");
+ * // returns false
+ *
+ * @example
+ * startsWith("test", "");
+ * // returns true (empty search string always matches)
+ *
+ * @example
+ * startsWith("abc", "abcd");
+ * // returns false
+ */
+export function startsWith(str: string, search: string): boolean;
 export const isProxySymbol: unique symbol;
 export const ngAttrPrefixes: string[];
 /**

package/Makefile

@@ -6,7 +6,7 @@ setup:
 	@npx playwright install
 
 BUILD_DIR = ./dist		
-build:
+build: version
 	@if [ -d "$(BUILD_DIR)" ]; then \
 		echo "Removing $(BUILD_DIR)..."; \
 		rm -r "$(BUILD_DIR)"; \
@@ -14,8 +14,11 @@ build:
 	@npm i
 	./node_modules/.bin/rollup -c
 
+version:
+	@node utils/version.cjs	
+
 pretty:
-	@npx prettier ./ --write
+	@npx prettier ./ --write --cache --log-level=silent
 	
 lint:
 	@npx eslint ./src --fix
@@ -28,10 +31,11 @@ types:
 	@rm -rf @types
 	@echo "Generating *.d.ts"
 	@npx -p typescript tsc --project tsconfig.types.json
+	$(MAKE) pretty
 
 
 TYPEDOC_DIR = docs/static/typedoc
-typedoc: types pretty
+doc: 
 	@rm -rf $(TYPEDOC_DIR)
 	@npm run generate-docs
 	@npx prettier ./typedoc --write
@@ -40,7 +44,7 @@ typedoc: types pretty
 serve:
 	@npm run serve
 
-prepare-release: test check types typedoc pretty build
+prepare-release: test check types doc pretty build
 
 PLAYWRIGHT_TEST := npx playwright test