@ekanos/integration-schema 0.1.0

package/dist/workspace-target.d.ts

@@ -0,0 +1,295 @@
+/**
+ * The canonical, dependency-pure workspace-target contract (F10): ONE schema
+ * for SDK authoring validation, host CI, and runtime normalization — no
+ * reduced reimplementation on the SDK side.
+ *
+ * Icon-NAME validity is the one host-specific rule this package cannot own:
+ * whether a string is a real Font Awesome / lucide name lives in the host
+ * design system (`@kit/ui/icon-shared`), which is not dependency-pure. So the
+ * schema validates the icon structurally (a bounded non-empty string) and
+ * accepts an INJECTED `isValidIcon` predicate: the host passes its own
+ * (`@kit/integrations-core`'s `workspace-target.schema.ts`), the SDK omits it
+ * (a partner's icon set is the host's to judge at the promotion gate). Every
+ * other rule — slug format, length bounds, the mutual-exclusivity of
+ * `inheritsWidgets`/`includedWidgetIds`, unique slugs, exactly-one-inheriting,
+ * the target count cap — is single-sourced here.
+ *
+ * Ported from `@kit/integrations-core`'s original schema; field constraints
+ * mirror the `workspaces` table (`apps/web/supabase/schemas/92-workspaces.sql`).
+ */
+import { z } from 'zod';
+export interface WorkspaceTargetSchemaOptions {
+    /**
+     * Host-injected icon-name validator. When provided, an icon that fails it
+     * is rejected; when omitted (SDK path), only the structural string check
+     * applies.
+     */
+    isValidIcon?: (icon: string) => boolean;
+}
+/** Stable URL segment — `/workspace/<slug>` routes reference it, so it may
+ * never contain anything needing escaping. */
+export declare const WorkspaceTargetSlugSchema: z.ZodString;
+/** Layouts a declaration may select. `'table'` still exists on the DB enum but
+ * is dead legacy since plan 038 — no declaration may write it. */
+export declare const WorkspaceTargetLayoutSchema: z.ZodEnum<["masonry", "two-column"]>;
+export declare function createWorkspaceTargetSchema(options?: WorkspaceTargetSchemaOptions): z.ZodEffects<z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    layout: z.ZodDefault<z.ZodEnum<["masonry", "two-column"]>>;
+    /**
+     * Whether this workspace receives the product's otherwise-unplaced
+     * widgets. Exactly one target per product must set it — see the list
+     * schema below.
+     */
+    inheritsWidgets: z.ZodOptional<z.ZodBoolean>;
+    /** Limit this workspace to specific widget ids. */
+    includedWidgetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>;
+/** Default (SDK-side) target schema: structural, no host icon-name check. */
+export declare const WorkspaceTargetSchema: z.ZodEffects<z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    layout: z.ZodDefault<z.ZodEnum<["masonry", "two-column"]>>;
+    /**
+     * Whether this workspace receives the product's otherwise-unplaced
+     * widgets. Exactly one target per product must set it — see the list
+     * schema below.
+     */
+    inheritsWidgets: z.ZodOptional<z.ZodBoolean>;
+    /** Limit this workspace to specific widget ids. */
+    includedWidgetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>;
+export type WorkspaceTargetDefinition = z.input<typeof WorkspaceTargetSchema>;
+/** A target after parsing, with `layout` defaulted. */
+export type ResolvedWorkspaceTarget = z.output<typeof WorkspaceTargetSchema>;
+/**
+ * A whole product's declaration set. The cross-target invariants (unique
+ * slugs, exactly one inheriting target, a max count) live here because none
+ * is checkable from inside a single target.
+ */
+export declare function createWorkspaceTargetListSchema(options?: WorkspaceTargetSchemaOptions): z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    layout: z.ZodDefault<z.ZodEnum<["masonry", "two-column"]>>;
+    /**
+     * Whether this workspace receives the product's otherwise-unplaced
+     * widgets. Exactly one target per product must set it — see the list
+     * schema below.
+     */
+    inheritsWidgets: z.ZodOptional<z.ZodBoolean>;
+    /** Limit this workspace to specific widget ids. */
+    includedWidgetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, "many">, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}[], {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}[]>;
+export declare const WorkspaceTargetListSchema: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    description: z.ZodOptional<z.ZodString>;
+    layout: z.ZodDefault<z.ZodEnum<["masonry", "two-column"]>>;
+    /**
+     * Whether this workspace receives the product's otherwise-unplaced
+     * widgets. Exactly one target per product must set it — see the list
+     * schema below.
+     */
+    inheritsWidgets: z.ZodOptional<z.ZodBoolean>;
+    /** Limit this workspace to specific widget ids. */
+    includedWidgetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}, {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}>, "many">, {
+    slug: string;
+    name: string;
+    layout: "masonry" | "two-column";
+    description?: string | undefined;
+    icon?: string | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}[], {
+    slug: string;
+    name: string;
+    description?: string | undefined;
+    icon?: string | undefined;
+    layout?: "masonry" | "two-column" | undefined;
+    inheritsWidgets?: boolean | undefined;
+    includedWidgetIds?: string[] | undefined;
+}[]>;
+/**
+ * Parses a declaration set and fills in the one benign omission the list
+ * schema tolerates (a single non-subset target that never set
+ * `inheritsWidgets`). Returns the issues instead of throwing so callers
+ * choose their own failure mode — CI fails the build, materialization logs
+ * and skips.
+ */
+export declare function normalizeWorkspaceTargets(declared: unknown, options?: WorkspaceTargetSchemaOptions): {
+    ok: false;
+    error: z.ZodError<{
+        slug: string;
+        name: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        layout?: "masonry" | "two-column" | undefined;
+        inheritsWidgets?: boolean | undefined;
+        includedWidgetIds?: string[] | undefined;
+    }[]>;
+    targets?: undefined;
+} | {
+    ok: true;
+    targets: {
+        slug: string;
+        name: string;
+        layout: "masonry" | "two-column";
+        description?: string | undefined;
+        icon?: string | undefined;
+        inheritsWidgets?: boolean | undefined;
+        includedWidgetIds?: string[] | undefined;
+    }[];
+    error?: undefined;
+};

package/dist/workspace-target.js

@@ -0,0 +1,150 @@
+/**
+ * The canonical, dependency-pure workspace-target contract (F10): ONE schema
+ * for SDK authoring validation, host CI, and runtime normalization — no
+ * reduced reimplementation on the SDK side.
+ *
+ * Icon-NAME validity is the one host-specific rule this package cannot own:
+ * whether a string is a real Font Awesome / lucide name lives in the host
+ * design system (`@kit/ui/icon-shared`), which is not dependency-pure. So the
+ * schema validates the icon structurally (a bounded non-empty string) and
+ * accepts an INJECTED `isValidIcon` predicate: the host passes its own
+ * (`@kit/integrations-core`'s `workspace-target.schema.ts`), the SDK omits it
+ * (a partner's icon set is the host's to judge at the promotion gate). Every
+ * other rule — slug format, length bounds, the mutual-exclusivity of
+ * `inheritsWidgets`/`includedWidgetIds`, unique slugs, exactly-one-inheriting,
+ * the target count cap — is single-sourced here.
+ *
+ * Ported from `@kit/integrations-core`'s original schema; field constraints
+ * mirror the `workspaces` table (`apps/web/supabase/schemas/92-workspaces.sql`).
+ */
+import { z } from 'zod';
+/** Stable URL segment — `/workspace/<slug>` routes reference it, so it may
+ * never contain anything needing escaping. */
+export const WorkspaceTargetSlugSchema = z
+    .string()
+    .trim()
+    .min(1, 'Slug is required')
+    .max(100)
+    .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, 'Must be lowercase alphanumeric with single hyphens between segments');
+/** Layouts a declaration may select. `'table'` still exists on the DB enum but
+ * is dead legacy since plan 038 — no declaration may write it. */
+export const WorkspaceTargetLayoutSchema = z.enum(['masonry', 'two-column']);
+export function createWorkspaceTargetSchema(options = {}) {
+    const iconSchema = z
+        .string()
+        .trim()
+        .min(1)
+        .max(100)
+        .refine((icon) => { var _a, _b; return (_b = (_a = options.isValidIcon) === null || _a === void 0 ? void 0 : _a.call(options, icon)) !== null && _b !== void 0 ? _b : true; }, {
+        message: 'Must be a valid icon',
+    });
+    return z
+        .object({
+        slug: WorkspaceTargetSlugSchema,
+        name: z.string().trim().min(1, 'Name is required').max(100),
+        icon: iconSchema.optional(),
+        description: z.string().trim().max(500).optional(),
+        layout: WorkspaceTargetLayoutSchema.default('masonry'),
+        /**
+         * Whether this workspace receives the product's otherwise-unplaced
+         * widgets. Exactly one target per product must set it — see the list
+         * schema below.
+         */
+        inheritsWidgets: z.boolean().optional(),
+        /** Limit this workspace to specific widget ids. */
+        includedWidgetIds: z.array(z.string().trim().min(1)).max(100).optional(),
+    })
+        .strict()
+        .superRefine((target, ctx) => {
+        var _a;
+        if (target.inheritsWidgets && target.includedWidgetIds) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['includedWidgetIds'],
+                message: 'inheritsWidgets and includedWidgetIds are mutually exclusive — a widget-subset workspace cannot also inherit unplaced widgets',
+            });
+        }
+        if (((_a = target.includedWidgetIds) === null || _a === void 0 ? void 0 : _a.length) === 0) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['includedWidgetIds'],
+                message: 'includedWidgetIds must list at least one widget id — omit the field for a workspace that inherits instead',
+            });
+        }
+    });
+}
+/** Default (SDK-side) target schema: structural, no host icon-name check. */
+export const WorkspaceTargetSchema = createWorkspaceTargetSchema();
+function refineTargetList(targets, ctx) {
+    const seenSlugs = new Set();
+    for (const [index, target] of targets.entries()) {
+        if (seenSlugs.has(target.slug)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [index, 'slug'],
+                message: `Duplicate workspace slug "${target.slug}" — every target in one declaration set needs its own slug`,
+            });
+        }
+        seenSlugs.add(target.slug);
+    }
+    if (targets.length === 0)
+        return;
+    const canInherit = (target) => !target.includedWidgetIds;
+    const inheriting = targets.filter((target) => canInherit(target) && target.inheritsWidgets);
+    if (inheriting.length === 1)
+        return;
+    // A lone non-subset target is unambiguous — `normalizeWorkspaceTargets`
+    // fills the flag in for it.
+    if (inheriting.length === 0 &&
+        targets.length === 1 &&
+        canInherit(targets[0])) {
+        return;
+    }
+    if (inheriting.length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'No target can receive this product’s unplaced widgets — exactly one target without includedWidgetIds must set inheritsWidgets: true',
+        });
+        return;
+    }
+    ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: `${inheriting.length} targets set inheritsWidgets — exactly one must, since a product has at most one inheriting attachment per scope`,
+    });
+}
+/**
+ * A whole product's declaration set. The cross-target invariants (unique
+ * slugs, exactly one inheriting target, a max count) live here because none
+ * is checkable from inside a single target.
+ */
+export function createWorkspaceTargetListSchema(options = {}) {
+    return z
+        .array(createWorkspaceTargetSchema(options))
+        .max(20)
+        .superRefine(refineTargetList);
+}
+export const WorkspaceTargetListSchema = createWorkspaceTargetListSchema();
+/**
+ * Parses a declaration set and fills in the one benign omission the list
+ * schema tolerates (a single non-subset target that never set
+ * `inheritsWidgets`). Returns the issues instead of throwing so callers
+ * choose their own failure mode — CI fails the build, materialization logs
+ * and skips.
+ */
+export function normalizeWorkspaceTargets(declared, options = {}) {
+    const parsed = createWorkspaceTargetListSchema(options).safeParse(declared);
+    if (!parsed.success) {
+        return { ok: false, error: parsed.error };
+    }
+    const targets = parsed.data;
+    if (targets.length === 1 &&
+        !targets[0].includedWidgetIds &&
+        !targets[0].inheritsWidgets) {
+        return {
+            ok: true,
+            targets: [Object.assign(Object.assign({}, targets[0]), { inheritsWidgets: true })],
+        };
+    }
+    return { ok: true, targets };
+}
+//# sourceMappingURL=workspace-target.js.map

package/dist/workspace-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-target.js","sourceRoot":"","sources":["../src/workspace-target.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The canonical, dependency-pure workspace-target contract (F10): ONE schema\n * for SDK authoring validation, host CI, and runtime normalization — no\n * reduced reimplementation on the SDK side.\n *\n * Icon-NAME validity is the one host-specific rule this package cannot own:\n * whether a string is a real Font Awesome / lucide name lives in the host\n * design system (`@kit/ui/icon-shared`), which is not dependency-pure. So the\n * schema validates the icon structurally (a bounded non-empty string) and\n * accepts an INJECTED `isValidIcon` predicate: the host passes its own\n * (`@kit/integrations-core`'s `workspace-target.schema.ts`), the SDK omits it\n * (a partner's icon set is the host's to judge at the promotion gate). Every\n * other rule — slug format, length bounds, the mutual-exclusivity of\n * `inheritsWidgets`/`includedWidgetIds`, unique slugs, exactly-one-inheriting,\n * the target count cap — is single-sourced here.\n *\n * Ported from `@kit/integrations-core`'s original schema; field constraints\n * mirror the `workspaces` table (`apps/web/supabase/schemas/92-workspaces.sql`).\n */\nimport { z } from 'zod';\n\nexport interface WorkspaceTargetSchemaOptions {\n  /**\n   * Host-injected icon-name validator. When provided, an icon that fails it\n   * is rejected; when omitted (SDK path), only the structural string check\n   * applies.\n   */\n  isValidIcon?: (icon: string) => boolean;\n}\n\n/** Stable URL segment — `/workspace/<slug>` routes reference it, so it may\n * never contain anything needing escaping. */\nexport const WorkspaceTargetSlugSchema = z\n  .string()\n  .trim()\n  .min(1, 'Slug is required')\n  .max(100)\n  .regex(\n    /^[a-z0-9]+(?:-[a-z0-9]+)*$/,\n    'Must be lowercase alphanumeric with single hyphens between segments',\n  );\n\n/** Layouts a declaration may select. `'table'` still exists on the DB enum but\n * is dead legacy since plan 038 — no declaration may write it. */\nexport const WorkspaceTargetLayoutSchema = z.enum(['masonry', 'two-column']);\n\nexport function createWorkspaceTargetSchema(\n  options: WorkspaceTargetSchemaOptions = {},\n) {\n  const iconSchema = z\n    .string()\n    .trim()\n    .min(1)\n    .max(100)\n    .refine((icon) => options.isValidIcon?.(icon) ?? true, {\n      message: 'Must be a valid icon',\n    });\n\n  return z\n    .object({\n      slug: WorkspaceTargetSlugSchema,\n      name: z.string().trim().min(1, 'Name is required').max(100),\n      icon: iconSchema.optional(),\n      description: z.string().trim().max(500).optional(),\n      layout: WorkspaceTargetLayoutSchema.default('masonry'),\n      /**\n       * Whether this workspace receives the product's otherwise-unplaced\n       * widgets. Exactly one target per product must set it — see the list\n       * schema below.\n       */\n      inheritsWidgets: z.boolean().optional(),\n      /** Limit this workspace to specific widget ids. */\n      includedWidgetIds: z.array(z.string().trim().min(1)).max(100).optional(),\n    })\n    .strict()\n    .superRefine((target, ctx) => {\n      if (target.inheritsWidgets && target.includedWidgetIds) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['includedWidgetIds'],\n          message:\n            'inheritsWidgets and includedWidgetIds are mutually exclusive — a widget-subset workspace cannot also inherit unplaced widgets',\n        });\n      }\n\n      if (target.includedWidgetIds?.length === 0) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['includedWidgetIds'],\n          message:\n            'includedWidgetIds must list at least one widget id — omit the field for a workspace that inherits instead',\n        });\n      }\n    });\n}\n\n/** Default (SDK-side) target schema: structural, no host icon-name check. */\nexport const WorkspaceTargetSchema = createWorkspaceTargetSchema();\n\nexport type WorkspaceTargetDefinition = z.input<typeof WorkspaceTargetSchema>;\n/** A target after parsing, with `layout` defaulted. */\nexport type ResolvedWorkspaceTarget = z.output<typeof WorkspaceTargetSchema>;\n\nfunction refineTargetList(\n  targets: ResolvedWorkspaceTarget[],\n  ctx: z.RefinementCtx,\n) {\n  const seenSlugs = new Set<string>();\n\n  for (const [index, target] of targets.entries()) {\n    if (seenSlugs.has(target.slug)) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: [index, 'slug'],\n        message: `Duplicate workspace slug \"${target.slug}\" — every target in one declaration set needs its own slug`,\n      });\n    }\n\n    seenSlugs.add(target.slug);\n  }\n\n  if (targets.length === 0) return;\n\n  const canInherit = (target: ResolvedWorkspaceTarget) =>\n    !target.includedWidgetIds;\n  const inheriting = targets.filter(\n    (target) => canInherit(target) && target.inheritsWidgets,\n  );\n\n  if (inheriting.length === 1) return;\n\n  // A lone non-subset target is unambiguous — `normalizeWorkspaceTargets`\n  // fills the flag in for it.\n  if (\n    inheriting.length === 0 &&\n    targets.length === 1 &&\n    canInherit(targets[0]!)\n  ) {\n    return;\n  }\n\n  if (inheriting.length === 0) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message:\n        'No target can receive this product’s unplaced widgets — exactly one target without includedWidgetIds must set inheritsWidgets: true',\n    });\n\n    return;\n  }\n\n  ctx.addIssue({\n    code: z.ZodIssueCode.custom,\n    message: `${inheriting.length} targets set inheritsWidgets — exactly one must, since a product has at most one inheriting attachment per scope`,\n  });\n}\n\n/**\n * A whole product's declaration set. The cross-target invariants (unique\n * slugs, exactly one inheriting target, a max count) live here because none\n * is checkable from inside a single target.\n */\nexport function createWorkspaceTargetListSchema(\n  options: WorkspaceTargetSchemaOptions = {},\n) {\n  return z\n    .array(createWorkspaceTargetSchema(options))\n    .max(20)\n    .superRefine(refineTargetList);\n}\n\nexport const WorkspaceTargetListSchema = createWorkspaceTargetListSchema();\n\n/**\n * Parses a declaration set and fills in the one benign omission the list\n * schema tolerates (a single non-subset target that never set\n * `inheritsWidgets`). Returns the issues instead of throwing so callers\n * choose their own failure mode — CI fails the build, materialization logs\n * and skips.\n */\nexport function normalizeWorkspaceTargets(\n  declared: unknown,\n  options: WorkspaceTargetSchemaOptions = {},\n) {\n  const parsed = createWorkspaceTargetListSchema(options).safeParse(declared);\n\n  if (!parsed.success) {\n    return { ok: false as const, error: parsed.error };\n  }\n\n  const targets = parsed.data;\n\n  if (\n    targets.length === 1 &&\n    !targets[0]!.includedWidgetIds &&\n    !targets[0]!.inheritsWidgets\n  ) {\n    return {\n      ok: true as const,\n      targets: [{ ...targets[0]!, inheritsWidgets: true }],\n    };\n  }\n\n  return { ok: true as const, targets };\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@ekanos/integration-schema",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Canonical, dependency-pure zod schema + types for Ekanos integration definitions. Depended on by @ekanos/sdk and @kit/integrations-core; depends on neither, so there is no cycle and there is exactly one schema, one inferred type.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/companydotcom/fusion.git",
+    "directory": "packages/integration-schema"
+  },
+  "homepage": "https://github.com/companydotcom/fusion/tree/dev/packages/integration-schema#readme",
+  "bugs": {
+    "url": "https://github.com/companydotcom/fusion/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "4.1.10",
+    "zod": "^3.25.74",
+    "@kit/eslint-config": "0.2.0",
+    "@kit/prettier-config": "0.1.0",
+    "@kit/tsconfig": "0.1.0"
+  },
+  "prettier": "@kit/prettier-config",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/rewrite-esm-specifiers.mjs",
+    "clean": "git clean -xdf .turbo node_modules dist",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}