@usenavii/core 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -183,6 +183,37 @@ declare function build(spec?: BuildSpec, options?: AvatarOptions): string;
  * ```
  */
 declare function createAvatar(seed: string, options?: AvatarOptions): string;
+/**
+ * Generate a random avatar without supplying a seed.
+ *
+ * Picks a fresh UUID seed via `crypto.randomUUID()` (or a `Math.random()`
+ * fallback when WebCrypto is unavailable) and renders the avatar. The seed
+ * is returned alongside the SVG so callers can **persist it** — e.g. save
+ * to the user's profile so future renders are stable.
+ *
+ * Use for: "spin again" UX, dev/demo seeding, lazy onboarding flows where
+ * the user gets an avatar before picking one.
+ *
+ * Each call returns a different avatar — DO NOT call inline in a render
+ * function or the avatar will change every re-render. Stabilize with a
+ * `useState`/`useMemo` init or persist the returned seed:
+ *
+ * @example
+ * ```ts
+ * const { svg, seed } = Navii.random({ size: 96 });
+ * saveToProfile(user.id, { naviiSeed: seed });
+ * ```
+ *
+ * @example React
+ * ```tsx
+ * const [random] = useState(() => Navii.random());
+ * return <Navii seed={random.seed} />;
+ * ```
+ */
+declare function random(options?: AvatarOptions): {
+    svg: string;
+    seed: string;
+};
 /**
  * Convenience namespace — bundles every public function under one import.
  *
@@ -198,6 +229,7 @@ declare function createAvatar(seed: string, options?: AvatarOptions): string;
  */
 declare const Navii: {
     readonly create: typeof createAvatar;
+    readonly random: typeof random;
     readonly render: typeof renderAvatar;
     readonly select: typeof selectAvatar;
     readonly group: typeof renderGroup;
@@ -205,4 +237,4 @@ declare const Navii: {
     readonly build: typeof build;
 };
 
-export { AccessoryId, AntennaStyleId, AvatarOptions, AvatarSpec, BackgroundId, BodyShapeId, type BuildSpec, EyeStyleId, type GroupOptions, MouthStyleId, Navii, OutfitId, type SeedFields, TopperId, build, createAvatar, createRng, cyrb53, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };
+export { AccessoryId, AntennaStyleId, AvatarOptions, AvatarSpec, BackgroundId, BodyShapeId, type BuildSpec, EyeStyleId, type GroupOptions, MouthStyleId, Navii, OutfitId, type SeedFields, TopperId, build, createAvatar, createRng, cyrb53, random, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };

package/dist/index.d.ts

@@ -183,6 +183,37 @@ declare function build(spec?: BuildSpec, options?: AvatarOptions): string;
  * ```
  */
 declare function createAvatar(seed: string, options?: AvatarOptions): string;
+/**
+ * Generate a random avatar without supplying a seed.
+ *
+ * Picks a fresh UUID seed via `crypto.randomUUID()` (or a `Math.random()`
+ * fallback when WebCrypto is unavailable) and renders the avatar. The seed
+ * is returned alongside the SVG so callers can **persist it** — e.g. save
+ * to the user's profile so future renders are stable.
+ *
+ * Use for: "spin again" UX, dev/demo seeding, lazy onboarding flows where
+ * the user gets an avatar before picking one.
+ *
+ * Each call returns a different avatar — DO NOT call inline in a render
+ * function or the avatar will change every re-render. Stabilize with a
+ * `useState`/`useMemo` init or persist the returned seed:
+ *
+ * @example
+ * ```ts
+ * const { svg, seed } = Navii.random({ size: 96 });
+ * saveToProfile(user.id, { naviiSeed: seed });
+ * ```
+ *
+ * @example React
+ * ```tsx
+ * const [random] = useState(() => Navii.random());
+ * return <Navii seed={random.seed} />;
+ * ```
+ */
+declare function random(options?: AvatarOptions): {
+    svg: string;
+    seed: string;
+};
 /**
  * Convenience namespace — bundles every public function under one import.
  *
@@ -198,6 +229,7 @@ declare function createAvatar(seed: string, options?: AvatarOptions): string;
  */
 declare const Navii: {
     readonly create: typeof createAvatar;
+    readonly random: typeof random;
     readonly render: typeof renderAvatar;
     readonly select: typeof selectAvatar;
     readonly group: typeof renderGroup;
@@ -205,4 +237,4 @@ declare const Navii: {
     readonly build: typeof build;
 };
 
-export { AccessoryId, AntennaStyleId, AvatarOptions, AvatarSpec, BackgroundId, BodyShapeId, type BuildSpec, EyeStyleId, type GroupOptions, MouthStyleId, Navii, OutfitId, type SeedFields, TopperId, build, createAvatar, createRng, cyrb53, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };
+export { AccessoryId, AntennaStyleId, AvatarOptions, AvatarSpec, BackgroundId, BodyShapeId, type BuildSpec, EyeStyleId, type GroupOptions, MouthStyleId, Navii, OutfitId, type SeedFields, TopperId, build, createAvatar, createRng, cyrb53, random, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };

package/dist/index.js

@@ -948,8 +948,18 @@ function createAvatar(seed2, options = {}) {
   }
   return renderAvatar(selectAvatar(seed2, options), options);
 }
+function random(options = {}) {
+  const seed2 = randomSeed();
+  return { svg: createAvatar(seed2, options), seed: seed2 };
+}
+function randomSeed() {
+  const c = globalThis.crypto;
+  if (c && typeof c.randomUUID === "function") return c.randomUUID();
+  return Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+}
 var Navii = {
   create: createAvatar,
+  random,
   render: renderAvatar,
   select: selectAvatar,
   group: renderGroup,
@@ -957,6 +967,6 @@ var Navii = {
   build
 };
 
-export { Navii, build, createAvatar, createRng, cyrb53, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };
+export { Navii, build, createAvatar, createRng, cyrb53, random, renderAvatar, renderAvatarInner, renderGroup, seed, selectAvatar };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map