@omnia/velcron 8.0.191-dev → 8.0.193-dev

package/internal-do-not-import-from-here/shared/models/Guid.d.ts

@@ -1,11 +1,32 @@
 import "./Equals";
 import { IEquals } from "./Equals";
 import { Id } from "./Id";
-export interface GuidValue extends Partial<IEquals<{
-    GUID(value: GuidValue): boolean;
-}>> {
-    toString: () => string;
-}
+type VersionChar = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f";
+type Char = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f";
+type Prev<X extends number> = [
+    never,
+    0,
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    8,
+    9,
+    10,
+    11,
+    ...never[]
+][X];
+type HasLength<S extends string, Len extends number> = [Len] extends [0] ? (S extends "" ? true : never) : (S extends `${infer C}${infer Rest}` ? (Lowercase<C> extends Char ? HasLength<Rest, Prev<Len>> : never) : never);
+type Char4<S extends string> = true extends HasLength<S, 4> ? S : never;
+type Char8<S extends string> = true extends HasLength<S, 8> ? S : never;
+type Char12<S extends string> = true extends HasLength<S, 12> ? S : never;
+type VersionGroup<S extends string> = S extends `${infer Version}${infer Rest}` ? (Version extends VersionChar ? (true extends HasLength<Rest, 3> ? S : never) : never) : never;
+type NilUUID = "00000000-0000-0000-0000-000000000000";
+type GuidValidator<S extends string> = S extends NilUUID ? S : (S extends `${infer S8}-${infer S4_1}-${infer S4_2}-${infer S4_3}-${infer S12}` ? (S8 extends Lowercase<Char8<S8>> ? (S4_1 extends Lowercase<Char4<S4_1>> ? (S4_2 extends Lowercase<VersionGroup<S4_2>> ? (S4_3 extends Lowercase<Char4<S4_3>> ? (S12 extends Lowercase<Char12<S12>> ? S : never) : never) : never) : never) : never) : never);
+export declare const emptyGuid: guid;
 declare const guidSymbol: unique symbol;
 /**
  * Type alias for GUIDs, represented as a string but with nominal typing
@@ -16,9 +37,10 @@ export type guid = Id<string, [typeof guidSymbol]>;
  * Generates a globally unique identifier (GUID) or converts a provided string into a GUID.
  *
  * This function creates a new GUID if no argument is provided. If a string id is provided,
- * it is cast to a GUID. The new GUID is generated according to the version 4 UUID standard,
- * which uses random numbers. The format of a version 4 UUID is 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx',
- * where 'x' is any hexadecimal digit and 'y' is one of 8, 9, A, or B.
+ * it is cast to a GUID, assuming the string is a valid, lowercase GUID. The new GUID is generated
+ * according to the version 4 UUID standard, which uses random numbers. The format of a version 4 UUID
+ * is 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx', where 'x' is any hexadecimal digit and 'y' is one of 8, 9, A, or B.
+ * Note: This function enforces that all hexadecimal characters in the GUID are lowercase at build time.
  *
  * @param {string} [id] - Optional. A predefined string to be cast as a guid.
  * @returns {guid} A new GUID if no id is provided, or the provided id cast as a guid.
@@ -28,10 +50,33 @@ export type guid = Id<string, [typeof guidSymbol]>;
  * const newGuid = guid();
  *
  * @example
- * // Casts a given string to a GUID
+ * // Casts a given string to a GUID, the string must be lowercase
  * const specificGuid = guid("123e4567-e89b-12d3-a456-426614174000");
  */
-export declare function guid(id?: string): guid;
+export declare function guid<S extends string>(id?: GuidValidator<S>): guid;
+/**
+ * Casts a provided string to a GUID without enforcing format validation.
+ *
+ * This function casts any given string to a GUID type without validating
+ * its format at build time. It is particularly useful in scenarios where
+ * the GUID format is non-standard or where format validation is not necessary.
+ * Note that this function does not generate a new GUID; it only casts the provided string.
+ * Note: Even without format validation, the string should be in lowercase to comply with GUID standards.
+ *
+ * @param {string} id - A string to be cast as a guid.
+ * @returns {guid} The provided id cast as a guid.
+ *
+ * @example
+ * // Casts a given string to a GUID without validating its format
+ * const specificGuid = maybeGuid("123e4567-e89b-12d3-a456-426614174000");
+ */
+export declare function maybeGuid(id: string): guid;
+export declare function isValidGuid(guid: guid): boolean;
+export interface GuidValue extends Partial<IEquals<{
+    GUID(value: GuidValue): boolean;
+}>> {
+    toString: () => string;
+}
 /**
  * Class to create a guid
  */

package/internal-do-not-import-from-here/shared/models/Guid.js

@@ -1,19 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GUID = exports.Guid = exports.guid = void 0;
-//export interface GuidValue {
-//    :string;
-//}
+exports.GUID = exports.Guid = exports.isValidGuid = exports.maybeGuid = exports.guid = exports.emptyGuid = void 0;
 require("./Equals"); // ensure execute code in equals first
+exports.emptyGuid = guid("00000000-0000-0000-0000-000000000000");
 //This is the new modern implementation of guid not requiring a class
 const guidSymbol = Symbol("guid");
 /**
  * Generates a globally unique identifier (GUID) or converts a provided string into a GUID.
  *
  * This function creates a new GUID if no argument is provided. If a string id is provided,
- * it is cast to a GUID. The new GUID is generated according to the version 4 UUID standard,
- * which uses random numbers. The format of a version 4 UUID is 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx',
- * where 'x' is any hexadecimal digit and 'y' is one of 8, 9, A, or B.
+ * it is cast to a GUID, assuming the string is a valid, lowercase GUID. The new GUID is generated
+ * according to the version 4 UUID standard, which uses random numbers. The format of a version 4 UUID
+ * is 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx', where 'x' is any hexadecimal digit and 'y' is one of 8, 9, A, or B.
+ * Note: This function enforces that all hexadecimal characters in the GUID are lowercase at build time.
  *
  * @param {string} [id] - Optional. A predefined string to be cast as a guid.
  * @returns {guid} A new GUID if no id is provided, or the provided id cast as a guid.
@@ -23,10 +22,34 @@ const guidSymbol = Symbol("guid");
  * const newGuid = guid();
  *
  * @example
- * // Casts a given string to a GUID
+ * // Casts a given string to a GUID, the string must be lowercase
  * const specificGuid = guid("123e4567-e89b-12d3-a456-426614174000");
  */
 function guid(id) {
+    return defineGuid(id);
+}
+exports.guid = guid;
+/**
+ * Casts a provided string to a GUID without enforcing format validation.
+ *
+ * This function casts any given string to a GUID type without validating
+ * its format at build time. It is particularly useful in scenarios where
+ * the GUID format is non-standard or where format validation is not necessary.
+ * Note that this function does not generate a new GUID; it only casts the provided string.
+ * Note: Even without format validation, the string should be in lowercase to comply with GUID standards.
+ *
+ * @param {string} id - A string to be cast as a guid.
+ * @returns {guid} The provided id cast as a guid.
+ *
+ * @example
+ * // Casts a given string to a GUID without validating its format
+ * const specificGuid = maybeGuid("123e4567-e89b-12d3-a456-426614174000");
+ */
+function maybeGuid(id) {
+    return defineGuid(id);
+}
+exports.maybeGuid = maybeGuid;
+function defineGuid(id) {
     if (!id) {
         return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, c => {
             const r = Math.random() * 16 | 0;
@@ -36,12 +59,19 @@ function guid(id) {
     }
     return id;
 }
-exports.guid = guid;
+function isValidGuid(guid) {
+    if (guid === undefined || guid === null) {
+        return false;
+    }
+    const validRegex = /^[{]?[0-9a-fA-F]{8}[-]?([0-9a-fA-F]{4}[-]?){3}[0-9a-fA-F]{12}[}]?$/;
+    return validRegex.test(guid.toString());
+}
+exports.isValidGuid = isValidGuid;
 /**
  * Class to create a guid
  */
 class Guid {
-    static { this._empty = new Guid("00000000-0000-0000-0000-000000000000"); }
+    static { this._empty = guid("00000000-0000-0000-0000-000000000000"); }
     static newGuid() {
         return new Guid("xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, c => {
             const r = Math.random() * 16 | 0;

package/internal-do-not-import-from-here/shared/models/OmniaSharedBootstrapData.d.ts

@@ -30,5 +30,5 @@ export interface OmniaAnalytics {
     enabled: boolean;
 }
 export interface OmniaServiceToDnsMapping {
-    [serviceId: string]: string;
+    [serviceId: guid]: string;
 }

package/internal-do-not-import-from-here/shared/models/Tenant.d.ts

@@ -1,4 +1,4 @@
-import { GuidValue } from "./Guid";
+import { guid } from "./Guid";
 export interface TenantIdentifier {
-    id: GuidValue;
+    id: guid;
 }

package/internal-do-not-import-from-here/shared/models/Tokens.d.ts

@@ -1,15 +1,15 @@
-import { GuidValue } from "./Guid";
+import { guid } from "./Guid";
 export interface OmniaToken {
     tokenKey: string;
-    tokenRef: GuidValue;
+    tokenRef: guid;
     loginName: string;
     expires: number;
     forDevIntent: boolean;
 }
 export interface OmniaTokenRef {
-    tenantId: GuidValue;
+    tenantId: guid;
     identityId: string;
     hubIdentityId?: number;
-    tokenRef: GuidValue;
+    tokenRef: guid;
     localDev: boolean;
 }

package/internal-do-not-import-from-here/shared/models/Tooling.d.ts

@@ -0,0 +1,13 @@
+import { guid } from "./Guid";
+export interface IEnums$ {
+}
+declare global {
+    let o$: {
+        enums: IEnums$;
+    };
+    let enum$: <T>(name: string) => {
+        value: <T2 extends {
+            [name: string]: string | guid | number | boolean;
+        }>(value: T2) => Record<keyof T2, T>;
+    };
+}

package/internal-do-not-import-from-here/shared/models/Tooling.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/internal-do-not-import-from-here/shared/models/WorkerProxyFuncs.d.ts

@@ -1,9 +1,9 @@
 import { HttpResponse } from "./HttpCommon";
-import { Guid } from "./Guid";
+import { guid } from "./Guid";
 import { WorkerProxyFunction } from "./Workers";
 export declare const WorkerProxyFuncs: {
     ui: {
-        loadManifests: WorkerProxyFunction<Guid[], Guid[]>;
+        loadManifests: WorkerProxyFunction<guid[], guid[]>;
     };
     worker: {
         httpRequest: WorkerProxyFunction<{

package/internal-do-not-import-from-here/shared/models/WorkerProxyFuncs.js

@@ -6,13 +6,13 @@ exports.WorkerProxyFuncs = {
     //Worker to Ui functions
     ui: {
         loadManifests: {
-            id: new Guid_1.Guid("8fb843b7-936f-4fec-a462-77c087adb7de")
+            id: (0, Guid_1.guid)("8fb843b7-936f-4fec-a462-77c087adb7de")
         }
     },
     //Ui to worker functions
     worker: {
         httpRequest: {
-            id: new Guid_1.Guid("c77c5845-4ceb-4fe2-939a-36de94be6f6b")
+            id: (0, Guid_1.guid)("c77c5845-4ceb-4fe2-939a-36de94be6f6b")
         }
     }
 };

package/internal-do-not-import-from-here/shared/models/Workers.d.ts

@@ -1,14 +1,14 @@
-import { GuidValue } from "./Guid";
+import { guid } from "./Guid";
 import { OmniaSharedBootstrapData } from "./OmniaSharedBootstrapData";
 export interface WorkerProxyAction<TParamType> {
-    id: GuidValue;
+    id: guid;
 }
 export interface WorkerProxyFunction<TParamType, TReturnType> extends WorkerProxyAction<TParamType> {
 }
 export interface WorkerProxyMessage<T> {
-    id: GuidValue;
+    id: guid;
     data: T;
-    handlerId: GuidValue;
+    handlerId: guid;
     initiator: WorkerProxyFunctionInitiators;
 }
 export declare enum WorkerProxyFunctionInitiators {

package/internal-do-not-import-from-here/shared/models/hub/activities/ActivityRenderer.d.ts

@@ -1,8 +1,8 @@
-import { GuidValue } from "../../Guid";
+import { guid } from "../../Guid";
 import { Id } from "../../Id";
 import { VelcronAppDefinition } from "../../velcron";
-export type ActivityRendererId = Id<string, "ActivityRendererId">;
-export declare function ActivityRendererId(id: GuidValue): ActivityRendererId;
+export type ActivityRendererId = Id<guid, "ActivityRendererId">;
+export declare function ActivityRendererId(id: guid): ActivityRendererId;
 export interface ActivityRendererReference {
     id: ActivityRendererId;
     version: string;

package/internal-do-not-import-from-here/shared/models/hub/fileupload/TemporaryFileId.d.ts

@@ -1,4 +1,4 @@
-import { GuidValue } from "../../Guid";
+import { guid } from "../../Guid";
 import { Id } from "../../Id";
-export type TemporaryFileId = Id<GuidValue, "TemporaryFileId">;
-export declare function TemporaryFileId(id: GuidValue): TemporaryFileId;
+export type TemporaryFileId = Id<guid, "TemporaryFileId">;
+export declare function TemporaryFileId(id: guid): TemporaryFileId;

package/internal-do-not-import-from-here/shared/models/hub/targeting/ExternalIdentityProperty.js

@@ -1,14 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HubExternalIdentityProperty = void 0;
-const Guid_1 = require("../../Guid");
 const HubSource_1 = require("./HubSource");
 class HubExternalIdentityProperty {
     constructor(externalIdentityId) {
         this.externalIdentityId = externalIdentityId;
     }
     get propertySourceId() {
-        return (0, Guid_1.guid)(HubSource_1.HubSource.Id);
+        return HubSource_1.HubSource.Id;
     }
     get name() {
         return "identity";

package/internal-do-not-import-from-here/shared/models/hub/targeting/HubSource.d.ts

@@ -1,3 +1,4 @@
+import { guid } from "../../Guid";
 export declare class HubSource {
-    static Id: string;
+    static Id: guid;
 }

package/internal-do-not-import-from-here/shared/models/hub/targeting/HubSource.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HubSource = void 0;
+const Guid_1 = require("../../Guid");
 class HubSource {
-    static { this.Id = "eb4fde5f-4f3e-4c70-9893-3d9e048fda0c"; }
+    static { this.Id = (0, Guid_1.guid)("eb4fde5f-4f3e-4c70-9893-3d9e048fda0c"); }
 }
 exports.HubSource = HubSource;

package/internal-do-not-import-from-here/shared/models/theming/Blueprints.d.ts

@@ -4,7 +4,7 @@ import { TypographyValue } from "./Typography";
 export interface BoxDimensions extends Spacing {
 }
 import { TypographyBlueprint } from "./Typography";
-import { GuidValue, VelcronAppDefinition, VelcronRendererReference } from "@omnia/fx-models";
+import { guid, VelcronAppDefinition, VelcronRendererReference } from "@omnia/fx-models";
 export interface Blueprints {
     name?: string;
 }
@@ -36,7 +36,7 @@ export interface ChromeBlueprint {
     name?: string;
     colorSchemaType?: ColorSchemaType;
     header?: {
-        definitionId: GuidValue;
+        definitionId: guid;
         definition?: VelcronAppDefinition;
     };
     styles: {

package/internal-do-not-import-from-here/shared/models/theming/ThemeDefinitionV2.d.ts

@@ -1,4 +1,4 @@
-import { GuidValue } from "../Guid";
+import { guid } from "../Guid";
 import { BoxDimensions, ButtonBlueprint, ComponentBlueprints, SpacingBlueprints, TypographyBlueprints } from "./Blueprints";
 export type ThemeContextType = "default" | "admin" | "preview" | "color-context" | "designer";
 export interface ColorTypeResult<resultType> {
@@ -43,7 +43,7 @@ export interface ColorSchemas extends ColorSchemasReference {
     notification: ColorSchema;
 }
 export interface BlueprintsReference {
-    id: GuidValue;
+    id: guid;
 }
 export interface ColorSchemasReference {
     primary: BlueprintsReference;
@@ -59,7 +59,7 @@ export interface ColorSchemasReference {
     notification: BlueprintsReference;
 }
 export interface ThemeDefinitionReference {
-    id: GuidValue;
+    id: guid;
     name?: string;
     colors: ColorSchemasReference;
     typography: BlueprintsReference;
@@ -73,7 +73,7 @@ export interface ThemeDefinitionV2 extends ThemeDefinitionReference {
     components: ComponentBlueprints;
 }
 export interface ITemplateRegistration<TTemplateType = any> {
-    id: GuidValue;
+    id: guid;
     template: TTemplateType;
     hidden?: boolean;
     custom?: boolean;
@@ -81,7 +81,7 @@ export interface ITemplateRegistration<TTemplateType = any> {
 export type TemplateRegistrationType = "button" | "fill" | "border" | "tabs" | "chrome" | "chromes" | "components" | "spacings" | "spacing" | "typography" | "icons" | "colorschema" | "theme";
 export interface ITemplateRegistration<TTemplateType = any, TType = TemplateRegistrationType> {
     type: TemplateRegistrationType;
-    id: GuidValue;
+    id: guid;
     template: TTemplateType;
     hidden?: boolean;
     custom?: boolean;

package/internal-do-not-import-from-here/shared/models/theming/Typography.d.ts

@@ -1,9 +1,9 @@
-import { GuidValue } from "../Guid";
+import { guid } from "../Guid";
 import { FillDefinition } from "./ThemeDefinitionV2";
 export interface TypographyBlueprint {
     name: string;
     font?: {
-        id: GuidValue;
+        id: guid;
         family: string;
         cdn?: string;
     };
@@ -19,7 +19,7 @@ export interface TypographyBlueprint {
         s: TypographyDefinition;
         xs: TypographyDefinition;
         font?: {
-            id: GuidValue;
+            id: guid;
             family: string;
             cdn?: string;
         };
@@ -30,7 +30,7 @@ export interface TypographyBlueprint {
         s: TypographyDefinition;
         xs: TypographyDefinition;
         font?: {
-            id: GuidValue;
+            id: guid;
             family: string;
             cdn?: string;
         };
@@ -39,7 +39,7 @@ export interface TypographyBlueprint {
         l: TypographyDefinition;
         m: TypographyDefinition;
         font?: {
-            id: GuidValue;
+            id: guid;
             family: string;
             cdn?: string;
         };
@@ -47,7 +47,7 @@ export interface TypographyBlueprint {
     link: {
         m: TypographyDefinition;
         font?: {
-            id: GuidValue;
+            id: guid;
             family: string;
             cdn?: string;
         };

package/internal-do-not-import-from-here/shared/models/velcron/VelcronContentSection.d.ts

@@ -1,6 +1,6 @@
-import { GuidValue } from "../Guid";
+import { guid } from "../Guid";
 import { VelcronAppDefinition } from "./VelcronDefinition";
 export interface VelcronSectionInstance {
-    contentId: GuidValue;
+    contentId: guid;
     definition: VelcronAppDefinition;
 }

package/internal-do-not-import-from-here/shared/models/velcron/VelcronReference.d.ts

@@ -1,8 +1,8 @@
-import { GuidValue } from "../Guid";
+import { guid } from "../Guid";
 import { Id } from "../Id";
 import { VelcronAppDefinition } from "./VelcronDefinition";
-export type VelcronRendererId = Id<string, "VelcronRendererId">;
-export declare function VelcronRendererId(id: GuidValue): VelcronRendererId;
+export type VelcronRendererId = Id<guid, "VelcronRendererId">;
+export declare function VelcronRendererId(id: guid): VelcronRendererId;
 export interface VelcronRendererResolverReference {
     id: VelcronRendererId;
     resolver: string;

package/models/VelcronDefinitions.d.ts

@@ -2,7 +2,7 @@ import { VelcronOnUpdatedEvent, VelcronOnClosedEvent, VelcronOnCloseRequestedEve
 import { VelcroncomponentArrayType, VelcronPrimitiveType } from "./VelcronTypes";
 import { AssignOperators, VelcronHorizontalAlignments, VelcronIconTypes, VelcronActionTypes, VelcronVerticalAlignments } from "./Enums";
 import { DynamicState, VelcronDefinition, VelcronEffects, useVelcronThemingStore } from "..";
-import { GuidValue, PropertyConfiguration, PropertyValue, PropertyDefinition, PropertySetupBase } from "@omnia/fx/models";
+import { guid, PropertyConfiguration, PropertyValue, PropertyDefinition, PropertySetupBase } from "@omnia/fx/models";
 import { useVelcronColorSchemaStore } from "../stores/VelcronColorSchema";
 export interface ResolvedComponentRenderer {
     component: unknown;
@@ -69,7 +69,7 @@ export interface VelcronRenderContext {
     disposers: Array<() => void>;
     baseDefinition?: VelcronAppDefinition;
     subApp?: boolean;
-    subAppreferenceId?: GuidValue;
+    subAppreferenceId?: guid;
 }
 export interface VelcronRenderContextEventHandlers {
     receiving?: {
@@ -366,7 +366,7 @@ export interface VelcronRadioDefinition extends VelcronDefinition {
     events: VelcronOnUpdatedEvent;
 }
 export interface VelcronPropertyDefinitionValue {
-    definitionId: GuidValue;
+    definitionId: guid;
     value: PropertyValue;
     configuration: PropertyConfiguration<PropertyDefinition<any, any, any, PropertySetupBase>>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@omnia/velcron",
   "license": "MIT",
-  "version": "8.0.191-dev",
+  "version": "8.0.193-dev",
   "description": "Provide Omnia Velcron Stuffs.",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/stores/VelcronColorSchema.d.ts

@@ -1,4 +1,4 @@
-import { ColorDefinition, ColorSchema, ColorSchemaType, ColorSchemaTypes } from "@omnia/fx-models";
+import { ColorDefinition, ColorSchema, ColorSchemaType, ColorSchemaTypes, guid } from "@omnia/fx-models";
 import { useVelcronThemingStore } from ".";
 export declare const useVelcronColorSchemaStore: (newStateWithName?: string) => {
     state: {
@@ -9,7 +9,7 @@ export declare const useVelcronColorSchemaStore: (newStateWithName?: string) =>
         isContainer: boolean;
         name: string;
         colorSchemaType: "background" | "primary" | "secondary" | ColorSchemaTypes | "accent1" | "accent2" | "accent3" | "neutral" | "warning" | "notification" | "error" | "info" | "dynamic";
-        id: import("@omnia/fx-models").GuidValue;
+        id: guid;
     };
     get: {
         readonly colorSchema: ColorSchema;

package/stores/VelcronColorSchema.js

@@ -14,7 +14,7 @@ exports.useVelcronColorSchemaStore = (0, _1.defineVelcronStore)("ColorSchemaStor
                 isContainer: false,
                 name: (0, fx_models_1.valueOf)(""),
                 colorSchemaType: fx_models_1.ColorSchemaTypes.background,
-                id: fx_models_1.Guid.newGuid(),
+                id: (0, fx_models_1.guid)(),
             },
             //The private state is not reactive that means it will not trigger re-rendering of the component
             privateState: {