@dani-builder/strapi-plugin-builder 0.15.0 → 1.0.0

package/AGENTS.md

@@ -1,6 +1,6 @@
 # @dani-builder/strapi-plugin-builder
 
-Strapi v5 plugin providing 12 content types, 31 components, and smart API endpoints for a page builder CMS. Installed as a Strapi plugin — not used standalone.
+Strapi v5 plugin providing 12 content types, 35 components, and smart API endpoints for a page builder CMS. Installed as a Strapi plugin — not used standalone.
 
 ## Installation & Setup
 
@@ -33,7 +33,7 @@ prevent Strapi from booting.
 | category | categories | `api/builder/categories` | false | yes |
 | tag | tags | `api/builder/tags` | false | yes |
 | author | authors | `api/builder/authors` | false | no |
-| inquiry | inquiries | `api/builder/inquiries` | false | no |
+| inquiry | inquiries | Storage only; submit through forms | false | no |
 | series | all-series | `api/builder/all-series` | false | yes |
 
 ### Single Types (3)
@@ -46,7 +46,7 @@ prevent Strapi from booting.
 
 **Series quirk:** `pluralName` is `all-series` (not `series`) because Strapi requires singular and plural names to differ.
 
-## Components (31)
+## Components (35)
 
 ### Blocks (14) — used in Page.blocks dynamic zone
 
@@ -56,9 +56,9 @@ prevent Strapi from booting.
 
 `elements.section`, `elements.footer`
 
-### Shared (15)
+### Shared (19)
 
-`shared.link`, `shared.seo`, `shared.feature-item`, `shared.highlight-item`, `shared.bento-item`, `shared.slider-item`, `shared.stat-item`, `shared.team-member`, `shared.testimonial-item`, `shared.pricing-tier`, `shared.logo-item`, `shared.navigation-group`, `shared.brand-colors`, `shared.analytics-setting`, `shared.chatbot-setting`, `shared.site-verification`
+`shared.analytics-setting`, `shared.bento-item`, `shared.brand-colors`, `shared.chatbot-setting`, `shared.feature-item`, `shared.highlight-item`, `shared.image`, `shared.link`, `shared.logo-item`, `shared.navigation-group`, `shared.organization`, `shared.postal-address`, `shared.pricing-tier`, `shared.seo`, `shared.site-verification`, `shared.slider-item`, `shared.stat-item`, `shared.team-member`, `shared.testimonial-item`
 
 ## Smart API Endpoints
 
@@ -87,17 +87,19 @@ Blocks use a `variant` enum instead of separate components per layout. Only use
 
 | Block | Variants |
 |---|---|
+| content | `prose`, `wide`, `full-width` |
+| cta | `inline-spread`, `inline-centered`, `inline-stacked`, `card-stacked`, `card-centered`, `card-horizontal` |
+| features | `simple-grid`, `dual-column`, `media-aside`, `media-aside-compact` |
 | hero | `side-by-side`, `media-extending`, `fullscreen-media`, `stacked-media` |
-| features | `simple-grid`, `card-grid`, `icon-grid` |
-| cta | `side-by-side`, `centered` |
-| pricing | `card-grid`, `comparison-table` |
-| testimonials | `card-grid`, `alternating`, `single-highlight` |
-| highlights | `media-aside`, `alternating`, `card-grid` |
-| bento-grid | `auto`, `featured-left`, `featured-right` |
-| stats | `simple-row`, `card-grid` |
-| team | `card-grid`, `simple-grid` |
-| logo-cloud | `simple-grid`, `ticker` |
-| slider | `fullscreen`, `card-carousel` |
+| highlights | `dual-column`, `triple-column`, `alternating` |
+| logo-cloud | `inline`, `grid`, `split`, `marquee` |
+| pricing | `two-column`, `three-column`, `single`, `with-comparison` |
+| slider | `cover-flow`, `card-slider` |
+| stats | `simple`, `card-grid`, `split` |
+| team | `grid`, `large-image`, `compact` |
+| testimonials | `centered`, `side-by-side`, `card-grid`, `subtle-grid` |
+
+`bento-grid`, `faq`, and `inquiry-form` have no variant attribute. A nullable variant uses the renderer default.
 
 **Never invent variant values** — always check the schema definition.
 
@@ -145,9 +147,15 @@ server/src/
 
 ## Peer Dependencies
 
-- `@strapi/strapi` ^5.0.0
+- `@strapi/provider-upload-aws-s3` ^5.36.0 (optional)
+- `@strapi/strapi` ^5.49.0
+- `@strapi/utils` ^5.49.0 (optional)
 - `@strapi/plugin-color-picker` ^5.0.0
 - `@d3levvv/strapi-react-icons-plugin` ^1.0.0
+- `react` ^17.0.0 || ^18.0.0
+- `react-router-dom` ^6.30.3
+- `@strapi/design-system` ^2.2.0
+- `@strapi/icons` ^2.2.0
 
 ## Publishing Type Subpaths
 

package/README.md

@@ -1,6 +1,6 @@
 # @dani-builder/strapi-plugin-builder
 
-Reusable CMS building blocks for **Strapi v5** — 12 content types, 31 block/element
+Reusable CMS building blocks for **Strapi v5** — 12 content types, 35 block/element/shared
 components, and a "smart API" that returns fully deep-populated pages and globals
 in a single request. Powers the [Daniworks Builder](https://github.com/HJ-company/daniworks-builder-v2)
 block-based site builder.
@@ -85,8 +85,8 @@ Configure Content API token or role permissions explicitly; the plugin does not
 automatically grant public access. Setup samples are in the
 [CMS content guide](https://github.com/HJ-company/daniworks-builder-v2/blob/main/docs/guides/cms-content.md#standalone-legal-document-setup-samples).
 
-The `inquiry` endpoint is write-only (`POST /api/builder/inquiries`) and IP
-rate-limited so submitter PII cannot be listed over the public API.
+Inquiry remains a storage target. Submit through the rate-limited
+`POST /api/builder/forms/:slug/submissions`; legacy Inquiry routes are removed.
 
 ## Extending from your project
 
@@ -100,7 +100,8 @@ Claude Code users get the same procedure as the `builder-extender` skill.
 
 ## Smart API
 
-Deep-populated, published-only reads (drafts never leak):
+Deep-populated reads default to published content; authenticated Page requests may
+explicitly request drafts with `status=draft`:
 
 | Method | Endpoint                         | Purpose                          |
 | ------ | -------------------------------- | -------------------------------- |
@@ -113,3 +114,22 @@ Consume it with [`@dani-builder/strapi-client`](https://www.npmjs.com/package/@d
 ## License
 
 MIT © HJ-company
+
+### Builder Forms admin
+
+Open **Builder Forms** in the Strapi admin menu to list, inspect and export saved
+form definitions. Administrators with **Builder → Forms → Update** permission can
+also create forms, edit target field selection and order, labels, placeholders,
+help text, required/hidden settings, enumeration labels and consent text/version.
+Schema constraints are retained; schema-required fields cannot be removed or made
+optional. The target selector supports eligible consumer `api::*` types. Slugs are immutable after creation. Forms with submissions
+cannot be deleted; the server's error is shown and the row is retained.
+
+Export downloads the saved portable JSON definition. Import accepts a JSON file or
+pasted JSON; use the list to create a new form, or the detail screen to replace the
+saved definition with a matching slug. New imports start at form version 1;
+replacement imports and ordinary saves increment the server-owned form version.
+The separate consent version is preserved. Ordinary saves preserve existing
+notification configuration; exported credentials are masked, so imports do not
+transfer notification secrets to another CMS. Notification configuration and
+submission management screens are deferred to a later release.

package/dist/admin/api.d.ts

@@ -0,0 +1,16 @@
+import type { useFetchClient } from "@strapi/strapi/admin";
+import type { FormDocument, FormDraft, FormField, FormTarget } from "./form";
+type Client = ReturnType<typeof useFetchClient>;
+export declare function formApi(client: Client): {
+    list(): Promise<FormDocument[]>;
+    get(id: string): Promise<FormDocument>;
+    targets(): Promise<FormTarget[]>;
+    fields(targetUid: string): Promise<FormField[]>;
+    save(form: FormDraft, id?: string): Promise<FormDocument>;
+    remove(id: string): Promise<void>;
+    export(id: string): Promise<Record<string, unknown>>;
+    import(data: Record<string, unknown>, id?: string): Promise<FormDocument>;
+};
+export declare function downloadForm(value: Record<string, unknown>, slug: string): void;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/admin/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../admin/src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE7E,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM;;YAKpB,MAAM;;sBAWI,MAAM;eAOb,SAAS,OAAO,MAAM;eAWtB,MAAM;eAGN,MAAM;iBAOJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,MAAM;EAa1D;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,QASxE"}

package/dist/admin/app.d.ts

@@ -0,0 +1,2 @@
+export default function App(): import("react").JSX.Element;
+//# sourceMappingURL=app.d.ts.map

package/dist/admin/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../admin/src/app.tsx"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,GAAG,gCAgC1B"}

package/dist/admin/field-editor.d.ts

@@ -0,0 +1,8 @@
+import type { FormField } from "./form";
+export declare function FieldEditor({ fields, schema, disabled, onChange, }: {
+    fields: FormField[];
+    schema: FormField[];
+    disabled: boolean;
+    onChange: (fields: FormField[]) => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=field-editor.d.ts.map

package/dist/admin/field-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-editor.d.ts","sourceRoot":"","sources":["../../admin/src/field-editor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;CACzC,+BA6IA"}

package/dist/admin/form-editor-page.d.ts

@@ -0,0 +1,4 @@
+export declare function FormEditorPage({ canUpdate }: {
+    canUpdate: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=form-editor-page.d.ts.map

package/dist/admin/form-editor-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-editor-page.d.ts","sourceRoot":"","sources":["../../admin/src/form-editor-page.tsx"],"names":[],"mappings":"AAUA,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,+BAwRnE"}

package/dist/admin/form-list-page.d.ts

@@ -0,0 +1,4 @@
+export declare function FormListPage({ canUpdate }: {
+    canUpdate: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=form-list-page.d.ts.map

package/dist/admin/form-list-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-list-page.d.ts","sourceRoot":"","sources":["../../admin/src/form-list-page.tsx"],"names":[],"mappings":"AAmBA,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,+BAmMjE"}

package/dist/admin/form.d.ts

@@ -0,0 +1,42 @@
+export interface FormField {
+    name: string;
+    type: string;
+    label: string;
+    required: boolean;
+    visibility: "form" | "hidden";
+    placeholder?: string;
+    help?: string;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    maxLength?: number;
+    min?: number;
+    max?: number;
+}
+export interface FormDraft {
+    slug: string;
+    name: string;
+    targetUid: string;
+    fields: FormField[];
+    consent: {
+        label: string;
+        version: string;
+    };
+}
+export interface FormDocument extends FormDraft {
+    documentId: string;
+    version: number;
+}
+export interface FormTarget {
+    uid: string;
+    name: string;
+}
+export declare const emptyForm: FormDraft;
+/** Explicitly omit notification configuration and all server-owned metadata. */
+export declare function savePayload(form: FormDraft): FormDraft;
+export declare function moveField(fields: FormField[], index: number, direction: number): FormField[];
+export declare function setRequired(field: FormField, required: boolean, schema: FormField): FormField;
+export declare function parseImport(source: string): Record<string, unknown>;
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=form.d.ts.map

package/dist/admin/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../admin/src/form.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AACD,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AACD,eAAO,MAAM,SAAS,EAAE,SAMvB,CAAC;AACF,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAWtD;AACD,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CAQb;AACD,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,SAAS,GAChB,SAAS,CAEX;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUnE;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUnD"}

package/dist/admin/import-form.d.ts

@@ -0,0 +1,6 @@
+export declare function ImportForm({ replace, disabled, onImport, }: {
+    replace?: boolean;
+    disabled?: boolean;
+    onImport: (value: Record<string, unknown>) => Promise<void>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=import-form.d.ts.map

package/dist/admin/import-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-form.d.ts","sourceRoot":"","sources":["../../admin/src/import-form.tsx"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,+BAiEA"}

package/dist/admin/index.d.ts

@@ -0,0 +1,6 @@
+import type { StrapiApp } from "@strapi/strapi/admin";
+declare const _default: {
+    register(app: StrapiApp): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../admin/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;;kBAGtC,SAAS;;AADzB,wBAWE"}