@cosmicdrift/kumiko-framework 0.389.0 → 0.390.0

package/dist/engine/pattern-library/static-schemas.js

@@ -1,487 +0,0 @@
-// Static pattern schemas (form-only, no closures).
-import { CLAIM_KEY_TYPE_OPTIONS, ID_TYPE_OPTIONS } from "./shared-fields.js";
-// --- Static patterns (form-only, no closures) -----------------------------
-export const requiresSchema = {
-    kind: "requires",
-    label: { en: "Requires", de: "Benötigt" },
-    summary: { en: "Hard dependency on other features." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "featureNames",
-            label: { en: "Feature names", de: "Feature-Namen" },
-            input: "string-list",
-            itemPlaceholder: "auth",
-            required: true,
-        },
-    ],
-};
-export const optionalRequiresSchema = {
-    kind: "optionalRequires",
-    label: { en: "Optional requires", de: "Optional benötigt" },
-    summary: { en: "Soft dependency — used if available, otherwise skipped." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "featureNames",
-            label: { en: "Feature names", de: "Feature-Namen" },
-            input: "string-list",
-            itemPlaceholder: "analytics",
-        },
-    ],
-};
-export const readsConfigSchema = {
-    kind: "readsConfig",
-    label: { en: "Reads config", de: "Liest Config" },
-    summary: { en: "Declares which qualified config keys this feature reads." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "qualifiedKeys",
-            label: { en: "Qualified keys", de: "Qualifizierte Keys" },
-            input: "string-list",
-            itemPlaceholder: "billing:plan",
-        },
-    ],
-};
-export const systemScopeSchema = {
-    kind: "systemScope",
-    label: { en: "System scope", de: "System-Scope" },
-    summary: { en: "Marks this feature as system-tenant only." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [],
-};
-export const adoptsBundledListsSchema = {
-    kind: "adoptsBundledLists",
-    label: { en: "Adopts bundled lists", de: "Übernimmt Bundled-Listen" },
-    summary: { en: "Feature packages only: takes the app-wide bundledLists table block." },
-    category: "meta",
-    editability: "opaque",
-    singleton: true,
-    fields: [],
-};
-export const toggleableSchema = {
-    kind: "toggleable",
-    label: { en: "Toggleable", de: "Umschaltbar" },
-    summary: { en: "Operator can switch this feature on/off per tenant." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "default",
-            label: { en: "Enabled by default", de: "Standardmäßig aktiviert" },
-            input: "boolean",
-            required: true,
-        },
-    ],
-};
-export const describeSchema = {
-    kind: "describe",
-    label: { en: "Description", de: "Beschreibung" },
-    summary: { en: "One-to-three-sentence docs-lead: what the feature does + when you need it." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "text",
-            label: { en: "Text", de: "Text" },
-            input: "textarea",
-            required: true,
-            placeholder: "Stores per-tenant widgets and exposes CRUD handlers for them.",
-        },
-    ],
-};
-export const uiHintsSchema = {
-    kind: "uiHints",
-    label: { en: "UI hints", de: "UI-Hinweise" },
-    summary: { en: "Picker/scaffolder metadata. Opaque to the Designer; rendered as raw TS source." },
-    category: "meta",
-    editability: "opaque",
-    singleton: true,
-    fields: [],
-};
-export const entitySchema = {
-    kind: "entity",
-    label: { en: "Entity", de: "Entität" },
-    summary: { en: "An aggregate stored as event-sourced read-model." },
-    category: "data",
-    editability: "static",
-    fields: [
-        {
-            path: "entityName",
-            label: { en: "Name", de: "Name" },
-            input: "text",
-            required: true,
-            placeholder: "task",
-        },
-        {
-            path: "definition.fields",
-            label: { en: "Fields", de: "Felder" },
-            input: "entity-fields-editor",
-            required: true,
-        },
-        {
-            path: "definition.idType",
-            label: { en: "ID type", de: "ID-Typ" },
-            input: "select",
-            options: ID_TYPE_OPTIONS,
-        },
-        {
-            path: "definition.softDelete",
-            label: { en: "Soft delete", de: "Soft-Delete" },
-            hint: { en: "Mark rows isDeleted=true instead of removing them." },
-            input: "boolean",
-        },
-        {
-            path: "definition.table",
-            label: { en: "Table name (override)", de: "Tabellenname (Override)" },
-            hint: { en: "Defaults to read_<plural-snake-case-name>." },
-            input: "text",
-        },
-    ],
-};
-export const relationSchema = {
-    kind: "relation",
-    label: { en: "Relation", de: "Beziehung" },
-    summary: { en: "Foreign-key relationship between entities." },
-    category: "data",
-    editability: "static",
-    fields: [
-        {
-            path: "entityName",
-            label: { en: "Owner entity", de: "Besitzende Entität" },
-            input: "entity-ref",
-            required: true,
-        },
-        {
-            path: "relationName",
-            label: { en: "Relation name", de: "Beziehungs-Name" },
-            input: "text",
-            required: true,
-            placeholder: "owner",
-        },
-        {
-            path: "definition",
-            label: { en: "Type", de: "Typ" },
-            input: "discriminated-union",
-            discriminator: "type",
-            variants: [
-                {
-                    tag: "belongsTo",
-                    label: { en: "Belongs to", de: "Gehört zu" },
-                    fields: [
-                        {
-                            path: "definition.target",
-                            label: { en: "Target entity", de: "Ziel-Entität" },
-                            input: "entity-ref",
-                            required: true,
-                        },
-                        {
-                            path: "definition.foreignKey",
-                            label: { en: "Foreign key column", de: "FK-Spalte" },
-                            input: "text",
-                            required: true,
-                        },
-                    ],
-                },
-                {
-                    tag: "hasMany",
-                    label: { en: "Has many", de: "Hat viele" },
-                    fields: [
-                        {
-                            path: "definition.target",
-                            label: { en: "Target entity", de: "Ziel-Entität" },
-                            input: "entity-ref",
-                            required: true,
-                        },
-                    ],
-                },
-                {
-                    tag: "manyToMany",
-                    label: { en: "Many to many", de: "Viele zu viele" },
-                    fields: [
-                        {
-                            path: "definition.target",
-                            label: { en: "Target entity", de: "Ziel-Entität" },
-                            input: "entity-ref",
-                            required: true,
-                        },
-                    ],
-                },
-            ],
-        },
-    ],
-};
-export const navSchema = {
-    kind: "nav",
-    label: { en: "Navigation entry", de: "Navigations-Eintrag" },
-    summary: { en: "Side-bar / menu link." },
-    category: "ui",
-    editability: "static",
-    fields: [
-        {
-            path: "definition.id",
-            label: { en: "ID", de: "ID" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "definition.label",
-            label: { en: "Label", de: "Beschriftung" },
-            input: "text",
-        },
-        {
-            path: "definition.screen",
-            label: { en: "Screen QN", de: "Screen-QN" },
-            hint: { en: "<feature>:screen:<id> qualified name." },
-            input: "text",
-        },
-        {
-            path: "definition.parent",
-            label: { en: "Parent nav", de: "Eltern-Nav" },
-            input: "text",
-        },
-    ],
-};
-export const workspaceSchema = {
-    kind: "workspace",
-    label: { en: "Workspace", de: "Arbeitsbereich" },
-    summary: { en: "Persona-/role-scoped UI surface." },
-    category: "ui",
-    editability: "static",
-    fields: [
-        {
-            path: "definition.id",
-            label: { en: "ID", de: "ID" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "definition.label",
-            label: { en: "Label", de: "Beschriftung" },
-            input: "text",
-        },
-    ],
-};
-export const configSchema = {
-    kind: "config",
-    label: { en: "Config keys", de: "Config-Keys" },
-    summary: { en: "Typed runtime configuration." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "keys",
-            label: { en: "Keys", de: "Keys" },
-            input: "key-value-map",
-            keyPlaceholder: "maxItems",
-            valueInput: "json-readonly",
-            required: true,
-        },
-    ],
-};
-export const translationsSchema = {
-    kind: "translations",
-    label: { en: "Translations", de: "Übersetzungen" },
-    summary: { en: "i18n strings keyed by locale." },
-    category: "meta",
-    editability: "static",
-    singleton: true,
-    fields: [
-        {
-            path: "keys",
-            label: { en: "Locales", de: "Sprachen" },
-            input: "key-value-map",
-            keyPlaceholder: "en",
-            valueInput: "json-readonly",
-            required: true,
-        },
-    ],
-};
-export const metricSchema = {
-    kind: "metric",
-    label: { en: "Metric", de: "Metrik" },
-    summary: { en: "Prometheus-style counter / gauge / histogram." },
-    category: "meta",
-    editability: "static",
-    fields: [
-        {
-            path: "shortName",
-            label: { en: "Short name", de: "Kurzname" },
-            hint: { en: "Snake-case; auto-prefixed with kumiko_<feature>_." },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "options.type",
-            label: { en: "Type", de: "Typ" },
-            input: "select",
-            options: [
-                { value: "counter", label: { en: "Counter" } },
-                { value: "gauge", label: { en: "Gauge" } },
-                { value: "histogram", label: { en: "Histogram" } },
-            ],
-            required: true,
-        },
-    ],
-};
-export const secretSchema = {
-    kind: "secret",
-    label: { en: "Secret", de: "Secret" },
-    summary: { en: "Tenant-scoped encrypted credential." },
-    category: "meta",
-    editability: "static",
-    fields: [
-        {
-            path: "shortName",
-            label: { en: "Short name", de: "Kurzname" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "options.label",
-            label: { en: "UI label (i18n)", de: "UI-Label (i18n)" },
-            hint: { en: "{ en: 'API Key', de: 'API-Schlüssel' }" },
-            input: "json-readonly",
-            required: true,
-        },
-        {
-            path: "options.scope",
-            label: { en: "Scope", de: "Geltungsbereich" },
-            input: "select",
-            options: [{ value: "tenant", label: { en: "Tenant" } }],
-        },
-        {
-            path: "options.writeRoles",
-            label: { en: "Write roles", de: "Schreibrollen" },
-            hint: {
-                en: "Roles allowed to set or delete. Leave empty to rely on the secrets handler access alone.",
-                de: "Rollen, die setzen oder löschen dürfen. Leer lassen, dann entscheidet allein der Handler-Zugriff.",
-            },
-            input: "string-list",
-        },
-    ],
-};
-export const secretNamespaceSchema = {
-    kind: "secretNamespace",
-    label: { en: "Secret namespace", de: "Secret-Namespace" },
-    summary: { en: "Family of tenant-scoped secrets with a runtime-chosen name." },
-    category: "meta",
-    editability: "static",
-    fields: [
-        {
-            path: "shortName",
-            label: { en: "Short name", de: "Kurzname" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "options.label",
-            label: { en: "UI label (i18n)", de: "UI-Label (i18n)" },
-            hint: { en: "{ en: 'Webhook token', de: 'Webhook-Token' }" },
-            input: "json-readonly",
-            required: true,
-        },
-        {
-            path: "options.scope",
-            label: { en: "Scope", de: "Geltungsbereich" },
-            input: "select",
-            options: [{ value: "tenant", label: { en: "Tenant" } }],
-        },
-        {
-            path: "options.writeRoles",
-            label: { en: "Write roles", de: "Schreibrollen" },
-            hint: {
-                en: "Roles allowed to set or delete. Leave empty to rely on the secrets handler access alone.",
-                de: "Rollen, die setzen oder löschen dürfen. Leer lassen, dann entscheidet allein der Handler-Zugriff.",
-            },
-            input: "string-list",
-        },
-    ],
-};
-export const claimKeySchema = {
-    kind: "claimKey",
-    label: { en: "Claim key", de: "Claim-Key" },
-    summary: { en: "Typed JWT claim contributed at login." },
-    category: "meta",
-    editability: "static",
-    fields: [
-        {
-            path: "shortName",
-            label: { en: "Short name", de: "Kurzname" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "claimType",
-            label: { en: "Type", de: "Typ" },
-            input: "select",
-            options: CLAIM_KEY_TYPE_OPTIONS,
-            required: true,
-        },
-    ],
-};
-export const referenceDataSchema = {
-    kind: "referenceData",
-    label: { en: "Reference data", de: "Referenzdaten" },
-    summary: { en: "Seed data for an entity (currencies, categories, …)." },
-    category: "data",
-    editability: "static",
-    fields: [
-        {
-            path: "entityName",
-            label: { en: "Entity", de: "Entität" },
-            input: "entity-ref",
-            required: true,
-        },
-        {
-            path: "data",
-            label: { en: "Rows", de: "Zeilen" },
-            input: "json-readonly",
-            required: true,
-        },
-        {
-            path: "upsertKey",
-            label: { en: "Upsert key", de: "Upsert-Key" },
-            hint: { en: "Field name to deduplicate on." },
-            input: "text",
-        },
-    ],
-};
-export const useExtensionSchema = {
-    kind: "useExtension",
-    label: { en: "Use extension", de: "Erweiterung nutzen" },
-    summary: { en: "Apply a registered registrar-extension to an entity." },
-    category: "advanced",
-    editability: "static",
-    fields: [
-        {
-            path: "extensionName",
-            label: { en: "Extension name", de: "Erweiterungs-Name" },
-            input: "text",
-            required: true,
-        },
-        {
-            path: "entityName",
-            label: { en: "Entity", de: "Entität" },
-            input: "entity-ref",
-            required: true,
-        },
-        {
-            path: "options",
-            label: { en: "Options", de: "Optionen" },
-            input: "json-readonly",
-        },
-    ],
-};

package/dist/engine/pattern-library/types.d.ts

@@ -1,158 +0,0 @@
-import type { FeaturePatternKind } from "../feature-ast/patterns.ts";
-export type FormInputType = "text" | "textarea" | "number" | "boolean" | "select" | "string-list" | "code-block" | "entity-fields-editor" | "key-value-map" | "discriminated-union" | "entity-ref" | "json-readonly";
-/**
- * Bilingual labels — Designer renders the user's locale, falls back to
- * `en`. AI-Builder uses `en` exclusively (cheaper prompts, single
- * grounding language for the model).
- */
-export type FormFieldLabel = {
-    readonly en: string;
-    readonly de?: string;
-};
-/**
- * Common shape every field carries — the input-specific fields are added
- * by the discriminated subtypes below.
- */
-type FormFieldBase = {
-    /**
-     * Dot/bracket-path inside the FeaturePattern. e.g. "entityName",
-     * "definition.fields", "access.roles", "templates.email".
-     */
-    readonly path: string;
-    readonly label: FormFieldLabel;
-    /**
-     * Short hint shown below the input. Optional — keep terse, the
-     * Designer / LLM is the doc consumer, not the casual reader.
-     */
-    readonly hint?: FormFieldLabel;
-    /**
-     * Whether the form should refuse to submit when this field is empty.
-     * Defaults to `false`. Validation runs *before* the patch hits the
-     * file — caller-side guard.
-     */
-    readonly required?: boolean;
-    /**
-     * Read-only fields are surfaced for context but never edited (e.g.
-     * `kind` discriminator, opaque source-spans on mixed patterns).
-     */
-    readonly readOnly?: boolean;
-};
-export type TextField = FormFieldBase & {
-    readonly input: "text";
-    readonly placeholder?: string;
-    readonly maxLength?: number;
-    readonly pattern?: string;
-};
-export type TextareaField = FormFieldBase & {
-    readonly input: "textarea";
-    readonly placeholder?: string;
-    readonly rows?: number;
-};
-export type NumberField = FormFieldBase & {
-    readonly input: "number";
-    readonly min?: number;
-    readonly max?: number;
-    readonly step?: number;
-};
-export type BooleanField = FormFieldBase & {
-    readonly input: "boolean";
-};
-export type SelectOption = {
-    readonly value: string;
-    readonly label: FormFieldLabel;
-};
-export type SelectField = FormFieldBase & {
-    readonly input: "select";
-    readonly options: readonly SelectOption[];
-};
-export type StringListField = FormFieldBase & {
-    readonly input: "string-list";
-    /** Per-item placeholder, e.g. "feature-name". */
-    readonly itemPlaceholder?: string;
-};
-export type CodeBlockField = FormFieldBase & {
-    readonly input: "code-block";
-    /**
-     * The source language for syntax highlighting. The skeleton renders
-     * everything as plain TS; later iterations can branch on `zod` /
-     * `tsx` for dedicated highlighters.
-     */
-    readonly language: "typescript" | "tsx" | "zod";
-};
-/**
- * Editor for `EntityDefinition.fields` — a row per field with name,
- * type-discriminator, plus type-specific knobs. Modeled as a single
- * input-type because the structure is too rich for a generic
- * key-value-map (each row's right-hand side is itself a discriminated
- * union over FieldDefinition variants).
- */
-export type EntityFieldsEditorField = FormFieldBase & {
-    readonly input: "entity-fields-editor";
-};
-/**
- * Generic `{ [key]: value }` editor — value-shape is described by an
- * inner FormSchema applied to each entry. Used for config-keys,
- * translations, projection.applyBodies, notification.templates.
- */
-export type KeyValueMapField = FormFieldBase & {
-    readonly input: "key-value-map";
-    /** Placeholder for new keys. */
-    readonly keyPlaceholder?: string;
-    /** What input renders for each value. Recursive — keep it simple. */
-    readonly valueInput: FormInputType;
-};
-export type DiscriminatedUnionField = FormFieldBase & {
-    readonly input: "discriminated-union";
-    /** Tag-property name (e.g. "type" for hook-target, "kind" for relation). */
-    readonly discriminator: string;
-    /** Each branch carries its own field-list. */
-    readonly variants: ReadonlyArray<{
-        readonly tag: string;
-        readonly label: FormFieldLabel;
-        readonly fields: readonly FormFieldSpec[];
-    }>;
-};
-export type EntityRefField = FormFieldBase & {
-    readonly input: "entity-ref";
-    /**
-     * If true, the input also accepts cross-feature references like
-     * `auth:event:loggedIn`. Default is feature-local only.
-     */
-    readonly allowQualified?: boolean;
-};
-export type JsonReadonlyField = FormFieldBase & {
-    readonly input: "json-readonly";
-};
-export type FormFieldSpec = TextField | TextareaField | NumberField | BooleanField | SelectField | StringListField | CodeBlockField | EntityFieldsEditorField | KeyValueMapField | DiscriminatedUnionField | EntityRefField | JsonReadonlyField;
-/**
- * High-level grouping the Designer uses for navigation: data shapes
- * (entity / relation), behaviour (handler / hook), UI (screen / nav),
- * meta (config / metric / secret), background (job / projection),
- * cross-cutting (notification / authClaims / httpRoute), advanced
- * (extendsRegistrar / unknown). Order in the Designer panel is alpha
- * inside a category.
- */
-export type PatternCategory = "data" | "behaviour" | "ui" | "meta" | "background" | "cross-cutting" | "advanced";
-export type PatternFormSchema = {
-    readonly kind: FeaturePatternKind;
-    readonly label: FormFieldLabel;
-    /** Short blurb shown in the Designer's "add new pattern" dialog. */
-    readonly summary: FormFieldLabel;
-    readonly category: PatternCategory;
-    /**
-     * Editability matches feature-ast's `getEditability()`:
-     *   - "static"  → fully form-driven, no closures
-     *   - "mixed"   → header is form, body is opaque code-block
-     *   - "opaque"  → entire pattern is read-only
-     */
-    readonly editability: "static" | "mixed" | "opaque";
-    /**
-     * Singleton kinds appear at most once per feature (requires,
-     * toggleable, config, …). The Designer hides "Add" once the
-     * singleton is present.
-     */
-    readonly singleton?: boolean;
-    /** Ordered list of editable fields. */
-    readonly fields: readonly FormFieldSpec[];
-};
-export {};

package/dist/engine/pattern-library/types.js

@@ -1,36 +0,0 @@
-// Forms-Schema metadata — describes how a FeaturePattern is rendered as
-// a Designer form, fed to an LLM as a JSON-Schema, or surfaced in the
-// MCP-Server tool list. One schema, three consumers — that's the whole
-// point of factoring this out of the hand-rolled skeleton.
-//
-// **NOT a DSL.** The Source-of-Truth for a feature stays
-// `defineFeature.ts` — the AST-visitor (feature-ast/parse.ts) reads it
-// and the renderer (feature-ast/render.ts) writes it. This file is
-// pure metadata for UI / LLM-prompt rendering: how to display the
-// already-parsed FeaturePattern in a form. No alternative parser, no
-// alternative syntax, no second canonical representation.
-//
-// **Vocabulary** (12 input-types):
-//
-//   text                  — single-line string (name / label / id)
-//   textarea              — multi-line string (description / SQL / readme)
-//   number                — numeric (version / fromVersion / rateLimit.limit)
-//   boolean               — checkbox (softDelete / default / openToAll)
-//   select                — closed enum (idType / hookType / method)
-//   string-list           — readonly string[] (featureNames / roles)
-//   code-block            — opaque TS source-span, read-only in the form
-//                            (schemaSource / handlerBody / fnBody)
-//   entity-fields-editor  — per-row editor for EntityDefinition.fields
-//   key-value-map         — generic { [key]: structured-value } editor
-//                            (config.keys / translations.keys / applyBodies)
-//   discriminated-union   — tagged sub-form (AccessRule: roles vs openToAll)
-//   entity-ref            — string with autocomplete against the registry
-//   json-readonly         — opaque pretty-printed JSON (Unknown / extension)
-//
-// **Path notation:** `path` references the value's location inside the
-// FeaturePattern object using dot-separated keys (`definition.fields`,
-// `access.roles`, `templates.email`). Numeric indices use the bracket
-// form (`columns.0`). The Designer/LLM uses paths for read & write —
-// the patcher consumes pattern-level updates only, so paths are
-// purely a UI concern at this stage.
-export {};