@nuvio/shared 0.5.4 → 1.0.0

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
 declare const NUVIO_WS_PATH: "/__nuvio/ws";
 
 /** Bump when wire payloads change incompatibly. */
-declare const PROTOCOL_VERSION: 7;
+declare const PROTOCOL_VERSION: 8;
 declare const riskLevelSchema: z.ZodEnum<["safe", "caution", "unsupported"]>;
 type RiskLevel = z.infer<typeof riskLevelSchema>;
 /** Index v3: editable text node under an instrumented host (Step 1). */
@@ -142,6 +142,12 @@ declare const tableDataFieldSchema: z.ZodObject<{
 }>;
 type TableDataFieldBinding = z.infer<typeof tableDataFieldSchema>;
 type HierarchyRole = z.infer<typeof hierarchyRoleSchema>;
+/** Per-host className patch strategy (index v5 / v0.7). */
+declare const classNameModeSchema: z.ZodEnum<["literal-only", "cn-basic", "cn-conditional", "classnames-static", "unsupported"]>;
+type WireClassNameMode = z.infer<typeof classNameModeSchema>;
+/** Detected UI library profile (v0.8). */
+declare const libraryIdSchema: z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>;
+type LibraryId = z.infer<typeof libraryIdSchema>;
 declare const indexEntrySchema: z.ZodObject<{
     id: z.ZodString;
     file: z.ZodString;
@@ -295,6 +301,10 @@ declare const indexEntrySchema: z.ZodObject<{
         arrayName: string;
         field: string;
     }>>;
+    /** Index v5: detected className expression mode for patch routing. */
+    classNameMode: z.ZodOptional<z.ZodEnum<["literal-only", "cn-basic", "cn-conditional", "classnames-static", "unsupported"]>>;
+    /** Index v6: shadcn / TailAdmin / DaisyUI hint for this host. */
+    libraryHint: z.ZodOptional<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>>;
 }, "strip", z.ZodTypeAny, {
     file: string;
     line: number;
@@ -357,6 +367,8 @@ declare const indexEntrySchema: z.ZodObject<{
         arrayName: string;
         field: string;
     } | undefined;
+    classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+    libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
 }, {
     file: string;
     line: number;
@@ -419,6 +431,8 @@ declare const indexEntrySchema: z.ZodObject<{
         arrayName: string;
         field: string;
     } | undefined;
+    classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+    libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
 }>;
 type IndexWireEntry = z.infer<typeof indexEntrySchema>;
 declare const runtimeDiagnosticsSchema: z.ZodObject<{
@@ -426,16 +440,20 @@ declare const runtimeDiagnosticsSchema: z.ZodObject<{
     reactVersion: z.ZodOptional<z.ZodString>;
     tailwindVersion: z.ZodOptional<z.ZodString>;
     overlayCssMode: z.ZodOptional<z.ZodLiteral<"self-contained">>;
+    /** Project-level library detection (v0.8). */
+    detectedLibraries: z.ZodOptional<z.ZodArray<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     viteVersion?: string | undefined;
     reactVersion?: string | undefined;
     tailwindVersion?: string | undefined;
     overlayCssMode?: "self-contained" | undefined;
+    detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
 }, {
     viteVersion?: string | undefined;
     reactVersion?: string | undefined;
     tailwindVersion?: string | undefined;
     overlayCssMode?: "self-contained" | undefined;
+    detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
 }>;
 type RuntimeDiagnostics = z.infer<typeof runtimeDiagnosticsSchema>;
 declare const duplicateIdOccurrenceSchema: z.ZodObject<{
@@ -813,6 +831,33 @@ declare const clientPatchUndoSchema: z.ZodObject<{
     requestId: string;
 }>;
 type ClientPatchUndo = z.infer<typeof clientPatchUndoSchema>;
+/** v0.6: insert data-nuvio-id at a dev-time source location (click-to-tag). */
+declare const clientTagElementSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tagElement">;
+    protocolVersion: z.ZodNumber;
+    requestId: z.ZodString;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    nuvioId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "tagElement";
+    file: string;
+    line: number;
+    column: number;
+    nuvioId: string;
+    protocolVersion: number;
+    requestId: string;
+}, {
+    type: "tagElement";
+    file: string;
+    line: number;
+    column: number;
+    nuvioId: string;
+    protocolVersion: number;
+    requestId: string;
+}>;
+type ClientTagElement = z.infer<typeof clientTagElementSchema>;
 declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"ping">;
     protocolVersion: z.ZodNumber;
@@ -993,6 +1038,30 @@ declare const clientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     type: "patchUndo";
     protocolVersion: number;
     requestId: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tagElement">;
+    protocolVersion: z.ZodNumber;
+    requestId: z.ZodString;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    nuvioId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "tagElement";
+    file: string;
+    line: number;
+    column: number;
+    nuvioId: string;
+    protocolVersion: number;
+    requestId: string;
+}, {
+    type: "tagElement";
+    file: string;
+    line: number;
+    column: number;
+    nuvioId: string;
+    protocolVersion: number;
+    requestId: string;
 }>]>;
 type ClientMessage = z.infer<typeof clientMessageSchema>;
 declare const serverPongSchema: z.ZodObject<{
@@ -1004,16 +1073,20 @@ declare const serverPongSchema: z.ZodObject<{
         reactVersion: z.ZodOptional<z.ZodString>;
         tailwindVersion: z.ZodOptional<z.ZodString>;
         overlayCssMode: z.ZodOptional<z.ZodLiteral<"self-contained">>;
+        /** Project-level library detection (v0.8). */
+        detectedLibraries: z.ZodOptional<z.ZodArray<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "pong";
@@ -1024,6 +1097,7 @@ declare const serverPongSchema: z.ZodObject<{
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }, {
     type: "pong";
@@ -1034,6 +1108,7 @@ declare const serverPongSchema: z.ZodObject<{
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }>;
 declare const serverErrorSchema: z.ZodObject<{
@@ -1209,6 +1284,10 @@ declare const serverIndexReadySchema: z.ZodObject<{
             arrayName: string;
             field: string;
         }>>;
+        /** Index v5: detected className expression mode for patch routing. */
+        classNameMode: z.ZodOptional<z.ZodEnum<["literal-only", "cn-basic", "cn-conditional", "classnames-static", "unsupported"]>>;
+        /** Index v6: shadcn / TailAdmin / DaisyUI hint for this host. */
+        libraryHint: z.ZodOptional<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>>;
     }, "strip", z.ZodTypeAny, {
         file: string;
         line: number;
@@ -1271,6 +1350,8 @@ declare const serverIndexReadySchema: z.ZodObject<{
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }, {
         file: string;
         line: number;
@@ -1333,6 +1414,8 @@ declare const serverIndexReadySchema: z.ZodObject<{
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }>, "many">;
     duplicateErrors: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -1369,16 +1452,20 @@ declare const serverIndexReadySchema: z.ZodObject<{
         reactVersion: z.ZodOptional<z.ZodString>;
         tailwindVersion: z.ZodOptional<z.ZodString>;
         overlayCssMode: z.ZodOptional<z.ZodLiteral<"self-contained">>;
+        /** Project-level library detection (v0.8). */
+        detectedLibraries: z.ZodOptional<z.ZodArray<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     entries: {
@@ -1443,6 +1530,8 @@ declare const serverIndexReadySchema: z.ZodObject<{
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }[];
     type: "indexReady";
     protocolVersion: number;
@@ -1460,6 +1549,7 @@ declare const serverIndexReadySchema: z.ZodObject<{
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }, {
     entries: {
@@ -1524,6 +1614,8 @@ declare const serverIndexReadySchema: z.ZodObject<{
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }[];
     type: "indexReady";
     protocolVersion: number;
@@ -1541,6 +1633,7 @@ declare const serverIndexReadySchema: z.ZodObject<{
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }>;
 type ServerIndexReady = z.infer<typeof serverIndexReadySchema>;
@@ -1875,6 +1968,32 @@ declare const serverPatchUndoAckSchema: z.ZodObject<{
     undoStackDepth?: number | undefined;
 }>;
 type ServerPatchUndoAck = z.infer<typeof serverPatchUndoAckSchema>;
+declare const serverTagElementAckSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tagElementAck">;
+    protocolVersion: z.ZodNumber;
+    requestId: z.ZodString;
+    ok: z.ZodBoolean;
+    id: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "tagElementAck";
+    protocolVersion: number;
+    requestId: string;
+    ok: boolean;
+    id?: string | undefined;
+    errorCode?: string | undefined;
+    errorMessage?: string | undefined;
+}, {
+    type: "tagElementAck";
+    protocolVersion: number;
+    requestId: string;
+    ok: boolean;
+    id?: string | undefined;
+    errorCode?: string | undefined;
+    errorMessage?: string | undefined;
+}>;
+type ServerTagElementAck = z.infer<typeof serverTagElementAckSchema>;
 declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"pong">;
     protocolVersion: z.ZodNumber;
@@ -1884,16 +2003,20 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion: z.ZodOptional<z.ZodString>;
         tailwindVersion: z.ZodOptional<z.ZodString>;
         overlayCssMode: z.ZodOptional<z.ZodLiteral<"self-contained">>;
+        /** Project-level library detection (v0.8). */
+        detectedLibraries: z.ZodOptional<z.ZodArray<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "pong";
@@ -1904,6 +2027,7 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }, {
     type: "pong";
@@ -1914,6 +2038,7 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"error">;
@@ -2087,6 +2212,10 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             arrayName: string;
             field: string;
         }>>;
+        /** Index v5: detected className expression mode for patch routing. */
+        classNameMode: z.ZodOptional<z.ZodEnum<["literal-only", "cn-basic", "cn-conditional", "classnames-static", "unsupported"]>>;
+        /** Index v6: shadcn / TailAdmin / DaisyUI hint for this host. */
+        libraryHint: z.ZodOptional<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>>;
     }, "strip", z.ZodTypeAny, {
         file: string;
         line: number;
@@ -2149,6 +2278,8 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }, {
         file: string;
         line: number;
@@ -2211,6 +2342,8 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }>, "many">;
     duplicateErrors: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -2247,16 +2380,20 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion: z.ZodOptional<z.ZodString>;
         tailwindVersion: z.ZodOptional<z.ZodString>;
         overlayCssMode: z.ZodOptional<z.ZodLiteral<"self-contained">>;
+        /** Project-level library detection (v0.8). */
+        detectedLibraries: z.ZodOptional<z.ZodArray<z.ZodEnum<["shadcn", "tailadmin", "daisyui"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }, {
         viteVersion?: string | undefined;
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     entries: {
@@ -2321,6 +2458,8 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }[];
     type: "indexReady";
     protocolVersion: number;
@@ -2338,6 +2477,7 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }, {
     entries: {
@@ -2402,6 +2542,8 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             arrayName: string;
             field: string;
         } | undefined;
+        classNameMode?: "unsupported" | "literal-only" | "cn-basic" | "cn-conditional" | "classnames-static" | undefined;
+        libraryHint?: "shadcn" | "tailadmin" | "daisyui" | undefined;
     }[];
     type: "indexReady";
     protocolVersion: number;
@@ -2419,6 +2561,7 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         reactVersion?: string | undefined;
         tailwindVersion?: string | undefined;
         overlayCssMode?: "self-contained" | undefined;
+        detectedLibraries?: ("shadcn" | "tailadmin" | "daisyui")[] | undefined;
     } | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"selectAck">;
@@ -2745,10 +2888,59 @@ declare const serverMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
     errorCode?: string | undefined;
     errorMessage?: string | undefined;
     undoStackDepth?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tagElementAck">;
+    protocolVersion: z.ZodNumber;
+    requestId: z.ZodString;
+    ok: z.ZodBoolean;
+    id: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "tagElementAck";
+    protocolVersion: number;
+    requestId: string;
+    ok: boolean;
+    id?: string | undefined;
+    errorCode?: string | undefined;
+    errorMessage?: string | undefined;
+}, {
+    type: "tagElementAck";
+    protocolVersion: number;
+    requestId: string;
+    ok: boolean;
+    id?: string | undefined;
+    errorCode?: string | undefined;
+    errorMessage?: string | undefined;
 }>]>;
 type ServerMessage = z.infer<typeof serverMessageSchema>;
 declare function parseClientMessage(raw: string): ClientMessage | null;
 declare function parseServerMessage(raw: string): ServerMessage | null;
 declare function serializeServerMessage(msg: ServerMessage): string;
 
-export { type Breakpoint, type ClientMessage, type ClientPatchApply, type ClientPatchUndo, type ClientPing, type ClientSelect, type DuplicateIdError, type HierarchyRole, type IndexWireEntry, NUVIO_WS_PATH, PROTOCOL_VERSION, type PatchOp, type RiskLevel, type RowWireTarget, type RuntimeDiagnostics, type ServerIndexReady, type ServerMessage, type ServerPatchAck, type ServerPatchUndoAck, type ServerSelectAck, type StyleWireTarget, type TableDataFieldBinding, type TableMeta, type TextWireTarget, breakpointSchema, clientMessageSchema, clientPatchApplySchema, clientPatchUndoSchema, clientPingSchema, clientSelectSchema, duplicateIdErrorSchema, duplicateIdOccurrenceSchema, hierarchyRoleSchema, indexEntrySchema, parseClientMessage, parseServerMessage, patchOpDuplicateHostSchema, patchOpMergeTailwindSchema, patchOpMoveSiblingSchema, patchOpSchema, patchOpSetHiddenSchema, patchOpSetTableDataFieldSchema, patchOpSetTextSchema, riskLevelSchema, rowTargetSchema, runtimeDiagnosticsSchema, serializeServerMessage, serverErrorSchema, serverIndexReadySchema, serverMessageSchema, serverPatchAckSchema, serverPatchUndoAckSchema, serverPongSchema, serverSelectAckSchema, styleTargetSchema, tableDataFieldSchema, tableMetaSchema, textTargetSchema };
+declare const LIBRARY_IDS: readonly ["shadcn", "tailadmin", "daisyui"];
+declare function librarySegmentForTag(tagName: string, libraryId: LibraryId): string | undefined;
+declare function isShadcnCompoundTag(tagName: string): boolean;
+/** Infer library from absolute/relative source file path. */
+declare function inferLibraryFromFilePath(filePath: string): LibraryId | undefined;
+declare function resolveEntryLibraryHint(filePath: string, tagName: string, detectedLibraries: readonly LibraryId[]): LibraryId | undefined;
+declare function detectShadcnComponentMode(tagName: string | undefined): "card" | "button" | "table" | "form" | null;
+declare function libraryGuidanceForEntry(entry: IndexWireEntry): string | undefined;
+declare function formatLibraryList(libraries: readonly LibraryId[]): string;
+
+/** Segmented id: `page.title`, `metric.orders.card` */
+declare const NUVIO_ID_PATTERN: RegExp;
+declare function isValidNuvioId(id: string): boolean;
+/**
+ * Suggest a segmented nuvio id from element tag and optional library context.
+ * Does not use element text or file paths.
+ */
+declare function suggestNuvioId(options: {
+    tagName: string;
+    existingIds: ReadonlySet<string>;
+    parentPrefix?: string;
+    libraryHint?: LibraryId;
+    componentName?: string;
+}): string;
+
+export { type Breakpoint, type ClientMessage, type ClientPatchApply, type ClientPatchUndo, type ClientPing, type ClientSelect, type ClientTagElement, type DuplicateIdError, type HierarchyRole, type IndexWireEntry, LIBRARY_IDS, type LibraryId, NUVIO_ID_PATTERN, NUVIO_WS_PATH, PROTOCOL_VERSION, type PatchOp, type RiskLevel, type RowWireTarget, type RuntimeDiagnostics, type ServerIndexReady, type ServerMessage, type ServerPatchAck, type ServerPatchUndoAck, type ServerSelectAck, type ServerTagElementAck, type StyleWireTarget, type TableDataFieldBinding, type TableMeta, type TextWireTarget, type WireClassNameMode, breakpointSchema, classNameModeSchema, clientMessageSchema, clientPatchApplySchema, clientPatchUndoSchema, clientPingSchema, clientSelectSchema, clientTagElementSchema, detectShadcnComponentMode, duplicateIdErrorSchema, duplicateIdOccurrenceSchema, formatLibraryList, hierarchyRoleSchema, indexEntrySchema, inferLibraryFromFilePath, isShadcnCompoundTag, isValidNuvioId, libraryGuidanceForEntry, libraryIdSchema, librarySegmentForTag, parseClientMessage, parseServerMessage, patchOpDuplicateHostSchema, patchOpMergeTailwindSchema, patchOpMoveSiblingSchema, patchOpSchema, patchOpSetHiddenSchema, patchOpSetTableDataFieldSchema, patchOpSetTextSchema, resolveEntryLibraryHint, riskLevelSchema, rowTargetSchema, runtimeDiagnosticsSchema, serializeServerMessage, serverErrorSchema, serverIndexReadySchema, serverMessageSchema, serverPatchAckSchema, serverPatchUndoAckSchema, serverPongSchema, serverSelectAckSchema, serverTagElementAckSchema, styleTargetSchema, suggestNuvioId, tableDataFieldSchema, tableMetaSchema, textTargetSchema };

package/dist/index.js

@@ -3,7 +3,7 @@ var NUVIO_WS_PATH = "/__nuvio/ws";
 
 // src/protocol.ts
 import { z } from "zod";
-var PROTOCOL_VERSION = 7;
+var PROTOCOL_VERSION = 8;
 var riskLevelSchema = z.enum(["safe", "caution", "unsupported"]);
 var textTargetSchema = z.object({
   /** Stable within host: `data-nuvio-id` or `loc:line:column`. */
@@ -65,6 +65,14 @@ var tableDataFieldSchema = z.object({
   rowKey: z.string(),
   field: z.string()
 });
+var classNameModeSchema = z.enum([
+  "literal-only",
+  "cn-basic",
+  "cn-conditional",
+  "classnames-static",
+  "unsupported"
+]);
+var libraryIdSchema = z.enum(["shadcn", "tailadmin", "daisyui"]);
 var indexEntrySchema = z.object({
   id: z.string(),
   file: z.string(),
@@ -99,13 +107,19 @@ var indexEntrySchema = z.object({
   /** Index v4: static table data binding for Tier C. */
   tableMeta: tableMetaSchema.optional(),
   /** Index v4: when this host maps to a `tableData` field edit. */
-  tableDataField: tableDataFieldSchema.optional()
+  tableDataField: tableDataFieldSchema.optional(),
+  /** Index v5: detected className expression mode for patch routing. */
+  classNameMode: classNameModeSchema.optional(),
+  /** Index v6: shadcn / TailAdmin / DaisyUI hint for this host. */
+  libraryHint: libraryIdSchema.optional()
 });
 var runtimeDiagnosticsSchema = z.object({
   viteVersion: z.string().optional(),
   reactVersion: z.string().optional(),
   tailwindVersion: z.string().optional(),
-  overlayCssMode: z.literal("self-contained").optional()
+  overlayCssMode: z.literal("self-contained").optional(),
+  /** Project-level library detection (v0.8). */
+  detectedLibraries: z.array(libraryIdSchema).optional()
 });
 var duplicateIdOccurrenceSchema = z.object({
   file: z.string(),
@@ -183,11 +197,21 @@ var clientPatchUndoSchema = z.object({
   protocolVersion: z.number().int(),
   requestId: z.string().min(1)
 });
+var clientTagElementSchema = z.object({
+  type: z.literal("tagElement"),
+  protocolVersion: z.number().int(),
+  requestId: z.string().min(1),
+  file: z.string().min(1),
+  line: z.number().int().positive(),
+  column: z.number().int().nonnegative(),
+  nuvioId: z.string().min(1)
+});
 var clientMessageSchema = z.discriminatedUnion("type", [
   clientPingSchema,
   clientSelectSchema,
   clientPatchApplySchema,
-  clientPatchUndoSchema
+  clientPatchUndoSchema,
+  clientTagElementSchema
 ]);
 var serverPongSchema = z.object({
   type: z.literal("pong"),
@@ -259,13 +283,23 @@ var serverPatchUndoAckSchema = z.object({
   errorCode: z.string().optional(),
   errorMessage: z.string().optional()
 });
+var serverTagElementAckSchema = z.object({
+  type: z.literal("tagElementAck"),
+  protocolVersion: z.number().int(),
+  requestId: z.string(),
+  ok: z.boolean(),
+  id: z.string().optional(),
+  errorCode: z.string().optional(),
+  errorMessage: z.string().optional()
+});
 var serverMessageSchema = z.discriminatedUnion("type", [
   serverPongSchema,
   serverErrorSchema,
   serverIndexReadySchema,
   serverSelectAckSchema,
   serverPatchAckSchema,
-  serverPatchUndoAckSchema
+  serverPatchUndoAckSchema,
+  serverTagElementAckSchema
 ]);
 function parseClientMessage(raw) {
   let json;
@@ -290,19 +324,212 @@ function parseServerMessage(raw) {
 function serializeServerMessage(msg) {
   return JSON.stringify(msg);
 }
+
+// src/library-registry.ts
+var LIBRARY_IDS = ["shadcn", "tailadmin", "daisyui"];
+var SHADCN_COMPOUND_TAGS = /* @__PURE__ */ new Set([
+  "Button",
+  "Card",
+  "CardHeader",
+  "CardTitle",
+  "CardDescription",
+  "CardContent",
+  "CardFooter",
+  "Input",
+  "Label",
+  "Badge",
+  "Table",
+  "TableHeader",
+  "TableBody",
+  "TableRow",
+  "TableCell",
+  "TableHead",
+  "Dialog",
+  "DialogTitle",
+  "DialogContent",
+  "DialogHeader"
+]);
+var SHADCN_TAG_SEGMENTS = {
+  Button: "button",
+  Card: "card",
+  CardHeader: "header",
+  CardTitle: "title",
+  CardDescription: "description",
+  CardContent: "content",
+  CardFooter: "footer",
+  Input: "input",
+  Label: "label",
+  Badge: "badge",
+  Table: "table",
+  TableHeader: "header",
+  TableBody: "body",
+  TableRow: "row",
+  TableCell: "cell",
+  TableHead: "header",
+  Dialog: "dialog",
+  DialogTitle: "title",
+  DialogContent: "content",
+  DialogHeader: "header"
+};
+var DAISYUI_CLASS_HINTS = /* @__PURE__ */ new Set(["btn", "card", "table", "navbar", "badge", "input"]);
+function librarySegmentForTag(tagName, libraryId) {
+  if (libraryId === "shadcn") {
+    return SHADCN_TAG_SEGMENTS[tagName];
+  }
+  if (libraryId === "daisyui") {
+    const lower = tagName.toLowerCase();
+    if (DAISYUI_CLASS_HINTS.has(lower)) {
+      return lower;
+    }
+  }
+  return void 0;
+}
+function isShadcnCompoundTag(tagName) {
+  return SHADCN_COMPOUND_TAGS.has(tagName);
+}
+function inferLibraryFromFilePath(filePath) {
+  const normalized = filePath.replace(/\\/g, "/").toLowerCase();
+  if (normalized.includes("/components/ui/")) {
+    return "shadcn";
+  }
+  if (normalized.includes("/layout/appsidebar") || normalized.includes("/components/ecommerce/") || normalized.includes("tailadmin")) {
+    return "tailadmin";
+  }
+  return void 0;
+}
+function resolveEntryLibraryHint(filePath, tagName, detectedLibraries) {
+  const fromPath = inferLibraryFromFilePath(filePath);
+  if (fromPath) {
+    return fromPath;
+  }
+  if (detectedLibraries.includes("shadcn") && isShadcnCompoundTag(tagName)) {
+    return "shadcn";
+  }
+  if (detectedLibraries.includes("daisyui")) {
+    const lower = tagName.toLowerCase();
+    if (DAISYUI_CLASS_HINTS.has(lower)) {
+      return "daisyui";
+    }
+  }
+  if (detectedLibraries.includes("tailadmin")) {
+    return "tailadmin";
+  }
+  return void 0;
+}
+function detectShadcnComponentMode(tagName) {
+  if (!tagName) {
+    return null;
+  }
+  if (tagName === "Button") {
+    return "button";
+  }
+  if (tagName === "Card" || tagName.startsWith("Card")) {
+    return "card";
+  }
+  if (tagName.startsWith("Table")) {
+    return "table";
+  }
+  if (tagName === "Input" || tagName === "Label") {
+    return "form";
+  }
+  return null;
+}
+function libraryGuidanceForEntry(entry) {
+  if (entry.libraryHint !== "shadcn") {
+    return void 0;
+  }
+  const tag = entry.tagName ?? "";
+  if (isShadcnCompoundTag(tag) && entry.riskLevel === "caution" && !entry.hasLiteralClassName) {
+    return "shadcn component \u2014 add className on the component call site, or tag a native child inside CardContent.";
+  }
+  if (tag.startsWith("Dialog") && entry.riskLevel === "unsupported") {
+    return "Dialog portal content may need a tagged host inside DialogContent.";
+  }
+  return void 0;
+}
+function formatLibraryList(libraries) {
+  if (libraries.length === 0) {
+    return "none detected";
+  }
+  return libraries.join(", ");
+}
+
+// src/suggest-nuvio-id.ts
+var NUVIO_ID_PATTERN = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/;
+function isValidNuvioId(id) {
+  return NUVIO_ID_PATTERN.test(id);
+}
+var NATIVE_TAG_SEGMENT = {
+  h1: "title",
+  h2: "title",
+  h3: "title",
+  h4: "title",
+  h5: "title",
+  h6: "title",
+  p: "text",
+  span: "label",
+  button: "button",
+  a: "link",
+  label: "label",
+  td: "cell",
+  th: "header",
+  li: "item",
+  img: "image",
+  input: "input",
+  div: "block",
+  section: "section",
+  article: "article",
+  header: "header",
+  footer: "footer",
+  nav: "nav",
+  main: "main"
+};
+function uniqueId(base, existing) {
+  if (!existing.has(base)) {
+    return base;
+  }
+  for (let i = 2; i < 100; i++) {
+    const candidate = `${base}${i}`;
+    if (!existing.has(candidate)) {
+      return candidate;
+    }
+  }
+  return `${base}.copy`;
+}
+function suggestNuvioId(options) {
+  const tag = options.tagName;
+  const librarySegment = options.libraryHint ? librarySegmentForTag(tag, options.libraryHint) : void 0;
+  const nativeSegment = NATIVE_TAG_SEGMENT[tag.toLowerCase()];
+  const segment = librarySegment ?? nativeSegment ?? "element";
+  const prefix = options.parentPrefix?.trim();
+  const base = prefix ? `${prefix}.${segment}` : `page.${segment}`;
+  return uniqueId(base, options.existingIds);
+}
 export {
+  LIBRARY_IDS,
+  NUVIO_ID_PATTERN,
   NUVIO_WS_PATH,
   PROTOCOL_VERSION,
   breakpointSchema,
+  classNameModeSchema,
   clientMessageSchema,
   clientPatchApplySchema,
   clientPatchUndoSchema,
   clientPingSchema,
   clientSelectSchema,
+  clientTagElementSchema,
+  detectShadcnComponentMode,
   duplicateIdErrorSchema,
   duplicateIdOccurrenceSchema,
+  formatLibraryList,
   hierarchyRoleSchema,
   indexEntrySchema,
+  inferLibraryFromFilePath,
+  isShadcnCompoundTag,
+  isValidNuvioId,
+  libraryGuidanceForEntry,
+  libraryIdSchema,
+  librarySegmentForTag,
   parseClientMessage,
   parseServerMessage,
   patchOpDuplicateHostSchema,
@@ -312,6 +539,7 @@ export {
   patchOpSetHiddenSchema,
   patchOpSetTableDataFieldSchema,
   patchOpSetTextSchema,
+  resolveEntryLibraryHint,
   riskLevelSchema,
   rowTargetSchema,
   runtimeDiagnosticsSchema,
@@ -323,7 +551,9 @@ export {
   serverPatchUndoAckSchema,
   serverPongSchema,
   serverSelectAckSchema,
+  serverTagElementAckSchema,
   styleTargetSchema,
+  suggestNuvioId,
   tableDataFieldSchema,
   tableMetaSchema,
   textTargetSchema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuvio/shared",
-  "version": "0.5.4",
+  "version": "1.0.0",
   "description": "Nuvio wire protocol (Zod), shared types, and path helpers for dev tooling.",
   "license": "MIT",
   "repository": {