@cratis/cast 0.1.0 → 0.2.0

package/README.md

@@ -10,4 +10,6 @@ import { defineConfig } from 'astro/config';
 export default defineConfig({ integrations: [cast()] });
 ```
 
-The quickest start is `npm create @cratis/cast@latest`. Documentation: [getting started](https://github.com/Cratis/Cast/blob/main/Documentation/getting-started.md), [cast.yaml reference](https://github.com/Cratis/Cast/blob/main/Documentation/cast-yaml.md), [badges and the registry](https://github.com/Cratis/Cast/blob/main/Documentation/badges-and-registry.md).
+The quickest start is `npm create @cratis/cast@latest`. Documentation: [getting started](https://github.com/Cratis/Cast/blob/main/Documentation/getting-started.md), [cast.yaml reference](https://github.com/Cratis/Cast/blob/main/Documentation/cast-yaml.md), [cast.json reference](https://github.com/Cratis/Cast/blob/main/Documentation/cast-json.md), [badges and the registry](https://github.com/Cratis/Cast/blob/main/Documentation/badges-and-registry.md).
+
+Besides the integration, the package exports what other Astro projects need to render a Cast profile: `@cratis/cast/profile` (`castView`, the hosts, the browser data), `@cratis/cast/machine` (`castJson`, `profileFromCastJson`, the cast.json schema) and the page components `@cratis/cast/site/pages/ProfilePage.astro` and `CvPage.astro`. The JSON Schemas are `@cratis/cast/cast.schema.json` (cast.yaml) and `@cratis/cast/cast-json.schema.json` (cast.json, version 2).

package/badges/RegistryMember.ts

@@ -10,6 +10,8 @@ export type RegistryMember = {
     since?: string;
     role?: string;
     site?: string;
+    /** URL of the member's /cast.json, for sites that publish it elsewhere. Defaults to `<site>/cast.json`. */
+    profile?: string;
     company?: string;
     /** 1-based line in members.yaml where this entry starts, for "verified from" links. */
     line?: number;

package/badges/registry.ts

@@ -12,6 +12,7 @@ export const registryMemberSchema = z.object({
     since: z.string().regex(/^\d{4}-\d{2}$/, 'Use YYYY-MM').optional(),
     role: z.string().min(1).optional(),
     site: z.url({ protocol: /^https$/ }).optional(),
+    profile: z.url({ protocol: /^https$/ }).optional(),
     company: z.string().min(1).optional(),
 }).strict();
 
@@ -58,6 +59,10 @@ function entryLines(document: ReturnType<typeof parseDocument>, yamlText: string
     });
 }
 
+/** Where the directory reads a member's profile: `profile`, else `<site>/cast.json`, else nowhere. */
+export const profileUrlOf = (member: Pick<RegistryMember, 'site' | 'profile'>): string | undefined =>
+    member.profile ?? (member.site ? new URL('/cast.json', member.site).toString() : undefined);
+
 /** Finds a member by GitHub login, case-insensitively. */
 export const findMember = (members: readonly RegistryMember[], handle: string): RegistryMember | undefined =>
     members.find(member => member.github.toLowerCase() === handle.toLowerCase());